Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 15 additions & 10 deletions docs/admin/permissions/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -38,13 +38,15 @@ To set up permissions by [syncing them from a code host](/admin/permissions/sync
- [Gerrit](/admin/auth/#gerrit)
- Bitbucket Server doesn't require an authentication provider, but has [other prerequisites](/admin/code_hosts/bitbucket_server#prerequisites)
- Perforce doesn't need a separate authentication provider
- [Azure DevOps](/admin/code_hosts/azuredevops)
2. Configure the code host connection to use authorization:
- [GitHub](/admin/code_hosts/github#repository-permissions)
- [GitLab](/admin/code_hosts/gitlab#repository-permissions)
- [Bitbucket Cloud](/admin/code_hosts/bitbucket_cloud#repository-permissions)
- [Bitbucket Server](/admin/code_hosts/bitbucket_server#repository-permissions)
- [Gerrit](/admin/code_hosts/gerrit#add-gerrit-as-an-authentication-provider)
- [Perforce](/admin/repo/perforce#repository-permissions)
- [Azure DevOps](/admin/code_hosts/azuredevops#permissions-syncing)

It's also possible to use other methods to get permission data from a code host into the Sourcegraph instance.

Expand All @@ -61,16 +63,18 @@ To know more about each method that we support, please follow the link above.
## Supported code hosts

Support for repository permissions accross different code hosts is different. The following table captures current state of support (ordered alphabetically):
| Code host | [Permission Syncing](/admin/permissions/syncing) | [Webhooks for Permissions](/admin/permissions/webhooks) | [Explicit API](/admin/permissions/api) | [Scale supported](#supported-scale) |
| -------- | -------- | -------- | -------- | -------- |
| Bitbucket Cloud (Beta) | ✓ | ✗ | ✓ | 10k users, 100k repositories |
| Bitbucket Server | ✓ | ✗ | ✓ | 10k users, 100k repositories |
| Gerrit (Beta) | ✓ | ✗ | ✓ | 10k users, 100k repositories |
| GitHub | ✓ | ✓ | ✓ | 40k users, 200k repositories |
| GitHub Enterprise | ✓ | ✓ | ✓ | 40k users, 200k repositories |
| GitLab | ✓ | ✗ | ✓ | 40k users, 200k repositories |
| GitLab Self-Managed | ✓ | ✗ | ✓ | 40k users, 200k repositories |
| Perforce (Beta) | Yes (with file-level permissions) | ✓ | ✓ | 10k users, 250k repositories |

| Code host | [Permission Syncing](/admin/permissions/syncing) | [Webhooks for Permissions](/admin/permissions/webhooks) | [Explicit API](/admin/permissions/api) | [Scale supported](#supported-scale) |
| ---------------------- | ------------------------------------------------ | ------------------------------------------------------- | -------------------------------------- | ----------------------------------- |
| Bitbucket Cloud (Beta) | ✓ | ✗ | ✓ | 10k users, 100k repositories |
| Bitbucket Server | ✓ | ✗ | ✓ | 10k users, 100k repositories |
| Gerrit (Beta) | ✓ | ✗ | ✓ | 10k users, 100k repositories |
| GitHub | ✓ | ✓ | ✓ | 40k users, 200k repositories |
| GitHub Enterprise | ✓ | ✓ | ✓ | 40k users, 200k repositories |
| GitLab | ✓ | ✗ | ✓ | 40k users, 200k repositories |
| GitLab Self-Managed | ✓ | ✗ | ✓ | 40k users, 200k repositories |
| Perforce (Beta) | Yes (with file-level permissions) | ✓ | ✓ | 10k users, 250k repositories |
| Azure Devops | ✓ | ✓ | ✓ | 10k users, 100k repositories |

All the other code hosts only support [Explicit permissions API](/admin/permissions/api).

Expand All @@ -92,6 +96,7 @@ in Sourcegraph.
- [Permission syncing SLA](/admin/permissions/syncing#sla)
- [Webhooks SLA](/admin/permissions/webhooks#sla)
- [Explicit Permissions API SLA](/admin/permissions/api#sla)

## License requirements

To have permission syncing available, the Sourcegraph instance needs to be configured with
Expand Down