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, people with a repository role, and their tokens | Anyone with the Write role |
| Public | Anyone, including builds that send no token | Anyone with the Write role |
To change it, follow these steps:
- Open the repository and go to Settings.
- Under Visibility, select Private or Public.
- Click Save changes.
Whether a public repository fetches files from its upstreams for a build that sends no token is decided by its When requesting a missing file without write access setting. Those requests and the storage they add count against the owner's plan.
Repository 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 always has the Admin role 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 Username field, enter the person's CodeSoh username.
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.
Tokens
A token can access a repository when its owner chose the repository for it on the Tokens page, and it never has a higher repository role than its owner. The Tokens with access section lists every such token. Someone with the Admin role can remove a token that names the repository. To remove a token that covers every repository its owner can access, remove the owner. For more information, see Tokens.