Using repository permissions
Bitbucket Server allows you to manage the permissions for just a single repository, or for a group of repositories together from the project.
Repository permissions allow you to extend access to a repository, for those who don't have project permissions. For example, you might use repository permissions to allow external developers or consultants access to a repository for special tasks or responsibilities.
Bitbucket Server supports 3 levels of permissions for repositories:
- Admin
- Write
- Read
Depending on the permission level for the repository that has been granted to you, you can perform different actions in the repository:
Browse | Clone, fork, pull | Create, browse or comment on a pull request | Merge a pull request | Push | Edit settings and permissions | |
|---|---|---|---|---|---|---|
| Admin |
|
|  | | | |
| Write |
|
| | |
|  |
| Read |
|
| | | | |
Note that:
- Anyone with permission to browse a pull request can create a task on any comment, and can browse, resolve and reopen existing tasks in the pull request.
- Repository admins and pull request authors can edit and delete any task in the pull request. Reviewers and others can only edit or delete their own tasks.
Granting access to a repository
To modify it's permissions, go to the repository's settings and click on Repository (under 'Permissions'). Click in the Add Users or Add Groups field in the relevant section to search for, and bulk add, users or groups. Now choose a permission from the list and click Add.
Once added, you can use the checkboxes to edit specific permissions for an individual user or a particular group.
Granting access to all repositories within a project
If you have a large number of repositories in a project, project level permissions provide a convenient way to grant access to all repositories within that project. For example you can grant a group, say "Team A", Write access at the project level, which will automatically give them Write access to all existing repositories in the project, as well as any repositories that are subsequently created in the project.
To modify permissions for a project, click the Permissions tab when viewing the project. You can add, or modify, permissions for individual users, and groups, in the same way as described above for a single repository.
Granting permission to create repositories
Only users with project administration permission can create new repositories.