A GitKraken organization is a collection of GitKraken accounts which unlocks a shared subscription, collaboration features between members, and administration of the members in the organization. If you are creating an account for the first time, an organization will automatically be created for you.
Create
To create an organization, go to app.gitkraken.com, or select “Manage Account” in the drop down menu inside of GitKraken Desktop, and select “New Organization” in the left side menu. Next, select the tier that is best for your organization (Pro, Teams, or Enterprise). The creator of the organization is automatically the owner of it.
You also have the option to purchase an organization for someone else that would be the owner and use the subscription. To do this, check “This purchase is for someone else” in the checkout page and it will ask who the owner is by email and sends them email instructions with next steps. You will be the owner of the organization until they accept, then you will be set as the Billing Contact.
Add Users
To add someone to your organization, go to app.gitkraken.com, select your organization in the left sidebar, select “Users,” and finally select “Add Users.”
Here you can enter as many email addresses as you want and the role (in the drop down) you would like to assign them all.
Only members that have a role with permission can add users to an organization. When you do add someone, it will consume a license of your subscription. If all available licenses are consumed when adding a user, a billing summary will show up during the process, select “Purchase” to complete the transaction and add the users.
You can also add licenses in bulk to your organization separately from adding users by going to the Subscription section in your organization.
Reallocate Licenses
Any Owner, Admin, or Billing Contact may remove users and then add users to reallocate licenses.
The Billing Contact role cannot remove or edit Owner or Admin users.
To reallocate a license, navigate to Users and then select “Remove” for the desired user. Then, you can add the new user.
Import and Export Users
To import multiple users via CSV select the “Add User” button. From here you can select “Import via CSV”. When importing users, be sure to have columns for Email, Username, Role, User License.
To export users to a CSV, select “Export via CSV”. The export will contain columns for Email, Username, Role, User License.
Roles
Roles grant members permissions within an organization. There are four roles a user may have:
- Owner: there must be exactly one owner per organization. Owners have full permission and consume a license.
- Admin: Admins have full permissions and consume a license. Admins cannot remove or edit the owner.
- User: Users have no administrative permissions but do consume a license.
- Billing Contact: Billing Contacts have the same permissions as admins, except they do not consume a license.
| Permission | Owner | Admin | User | Billing Contact |
|---|---|---|---|---|
| Licensed to use GitKraken | ✅ | ✅ | ✅ | |
| Add, edit, and remove users | ✅ | ✅ | ✅ | |
| Create and manage teams | ✅ | ✅ | ✅ | |
| Manage billing and purchase licenses | ✅ | ✅ | ✅ | |
| Transfer ownership of the organization | ✅ |
Teams
Teams are the best way to organize members of your GitKraken organization. In addition, teams can create Shared Workspaces to bring focus to their collaborative work and help identify conflicts by showing what files and branches your team is working on.
Any member can create a team by visiting the Teams tab within the organization at app.gitkraken.com or within GitKraken Desktop. For more information on creating and working with teams, see the Teams page.
SSO
Single sign-on (SSO) is available for organizations that require it. SSO requires:
- A Teams or Enterprise subscription (If you want to give SSO a try, start an org trial or reach out to us)
- A GitKraken organization
- A compatible Identity Provider (IDP) which is limited to:
- Azure Active Directory
- Okta
- Google Identity Platform (G Suite)
- Ping Identity
- SSO can only be set up by the Owner or by an Admin of the organization.
- SSO is set up at the Organization level. Each organization can have multiple IDPs connected simultaneously.
How to setup SSO
See how to setup SSO by visiting the Setting up SSO section.
Settings
Visiting the Settings section of your organization will give you a snapshot of your subscription and allow you to edit a few key aspects of your organization like changing the name and transferring ownership of the organization.
You can hide organizations that you do not wish to see from the sidebar view by checking the “Hide organization in the sidebar” box. You can also rename an organization by typing the desired name into Organization Name and then selecting “Save.”
Transfer Ownership
If you’re the owner of an organization and would like to make someone else the owner you can do that. First you need to make sure to first add that account to the organization. Once the account is added to your organization, go to your organization, select “Settings” and then “Transfer ownership.” You will select the user within the organization to become the owner (and type their email to confirm). Once you select “Transfer Ownership,” the transfer is final and cannot be undone unless the new owner transfers ownership back to the original owner.
Leave an Organization
If you no longer need to be a part of an organization, you can leave an organization by navigating to Settings and then Leave Organization. If you leave an organization, only an admin can invite you back. You will lose access to collaboration with members of GitKraken and your GitKraken paid license.
This option will only be available if you are part of another organization and you are not the owner of the organization. If you are the current owner, you can transfer the ownership and then leave the organization after.
