Get Your OSS Org on Rkito

Set up architecture decisions, design reviews, and engineering standards for your GitHub organization in minutes.

Prerequisites

GitHub Organization Admin Access

You must be an owner or have admin permissions in the GitHub organization

Rkito Account

Sign up for Rkito via GitHub. You'll be used as the initial org admin.

GitHub App Authorization

We need permission to read org membership and sync roles automatically

Installation Steps

1

Install the Rkito GitHub App

Click the button below. You'll be taken to GitHub's app authorization page. Select your organization and grant Rkito permission to read org membership.

Install on GitHub
2

Authorize GitHub Access

GitHub will ask for confirmation. Review the requested permissions and click "Authorize". Rkito needs to read:

  • Organization members and their roles
  • Organization metadata
3

Organization Created & Members Synced

Once authorized, Rkito will:

  • Create your organization in Rkito
  • Sync all GitHub org members
  • Assign Rkito roles based on GitHub roles (exact mapping below)
  • Send you to the dashboard
4

Invite Team Members

Team members can now log in via GitHub SSO. They'll automatically be assigned to the organization with their GitHub roles mapped to Rkito roles.

GitHub to Rkito Role Mapping

GitHub RoleRkito Role(s)Permissions
OwnerAdminManage members, roles, policies, approvals
MaintainerMaintainerApprove changes, set standards, governance
MemberContributorSubmit changes, propose decisions, participate in reviews

Frequently Asked Questions

What permissions does Rkito request?

Rkito reads org membership and roles to sync them automatically. We don't write to your GitHub organization. You can review all permissions during installation.

Can I uninstall the app?

Yes. You can uninstall the Rkito GitHub App anytime from your GitHub organization settings. However, member syncing will stop, and new team members won't be automatically assigned.

What if my team has already signed up individually?

When you install the app, Rkito matches GitHub identities with existing Rkito users by email. Members will be added to your organization automatically.

Do we have to use Rkito for the whole org?

No. Only team members who log in to Rkito will be set up. The app doesn't force participation—it enables it for those who want it.

How are roles managed after installation?

Rkito syncs roles on each login. If someone's GitHub role changes, their Rkito roles update automatically on next login. Org admins can also manually adjust roles in Rkito.

Ready to get started?

Install the Rkito GitHub App for your organization in one click.

Install Rkito GitHub App

Questions? Check out the Rkito docs or email us.