Organizations
Organizations group repositories under a shared namespace so a team can own and collaborate on projects together. Each organization has a unique slug that becomes its namespace in URLs and clone paths.
Creating an Organization
- Go to /orgs/new
- Enter an Organization name (the display name)
- Enter a Slug — lowercase letters, numbers, hyphens, and underscores only. It must be unique and is used in URLs.
- Optionally add a Description
- Click Create organization
The user who creates an organization automatically becomes its first member with the owner role.
Org-Owned Repositories
Repositories owned by an organization live under the org's slug as their namespace. For
example, a repository named api in the acme organization is at:
https://#git.vianet.us/acme/api
git@#git.vianet.us:acme/api.gitMembers with at least developer access can create repositories under the organization. Any member of an organization can read its repositories; reporters and guests cannot create new ones.
Members & Roles
Every member of an organization is assigned one of five roles:
| Role | Access |
|---|---|
| owner | Full control: manage members and roles, edit settings, delete the organization, and create repositories. |
| maintainer | Can create repositories under the organization. |
| developer | Can create repositories under the organization. This is the default role for new members. |
| reporter | Member access without the ability to create repositories. |
| guest | Member access without the ability to create repositories. |
Managing Members
Only owners can manage members. Open /<slug>/-/members to:
- Add a member — enter their username and pick a role (developer, maintainer, reporter, or guest), then click Add. The user must already have an account.
- Change a role — select a new role from the dropdown next to a member.
- Remove a member — click the remove button next to a member. You cannot remove yourself.
Members who aren't owners can view the member list but cannot make changes.
Organization Settings
Owners can open /<slug>/-/settings to update the organization's name and description. The settings page is restricted to owners.
The Danger zone lets an owner permanently delete the organization. Deleting an organization also deletes all of its repositories and cannot be undone.