Share a repository
A repository belongs to the account that created it. The owner can make it public, share it with individual people, and let tokens access it.
Visibility
A repository is Private or Public.
| Visibility | Who can read | Who can deploy |
|---|---|---|
| Private | The owner, the people it's shared with, and their tokens | Anyone with write permission |
| Public | Anyone, including builds with no credentials | Anyone with write permission |
To change it, follow these steps:
- Open the repository and go to Settings.
- Under Visibility, select Private or Public.
- Click Save changes.
Roles
| Role | Can do |
|---|---|
| Read | Resolve and download files, browse, search, and read the file activity |
| Write | Everything read can do, plus deploy files, delete files and versions where the settings allow it, and publish the index |
| Admin | Everything write can do, plus change settings, manage upstreams and content rules, manage sharing, manage custom domains, and read the settings activity |
The owner is always an administrator and can't be removed. Only the owner can delete the repository.
Share with a person
To share a repository, follow these steps:
- Open the repository and go to Access.
- In the People section, in the Handle field, enter the person's CodeSoh handle.
- In the Access list, select Read, Write, or Admin.
- Click Share.
They can then use the repository in their browser and with their own tokens. To change what someone can do, select another value in the Access column of their row.
To stop sharing, follow these steps:
- Open the repository and go to Access.
- In the person's row, click Remove.
Removing a person also removes the access of every token they own, so their build tools lose access at the same moment they do.
Tokens
A token can access a repository when its owner chose the repository for it on the Tokens page, and it never has more access than its owner does. The Tokens with access section lists every such token. An administrator can remove a token that names the repository; a token that covers every repository its owner can access is removed by removing the owner. For more information, see Tokens.