Skip to content
Merged
Show file tree
Hide file tree
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
7 changes: 7 additions & 0 deletions docs/admin/access_control/index.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,12 @@
# Access control

<TierCallout>
Supported on [Enterprise](/pricing/enterprise) plans.
<user>
Available via the Web app.
</user>
</TierCallout>

<Callout type="info">This feature is in Beta stage.</Callout>

> NOTE: This page refers to in-product permissions, which determine who can, for example, create a batch change, or who is a site admin. This is *not* the same as [repository permissions](/admin/permissions/), which enforces the same repository access on Sourcegraph as your code host.
Expand Down
7 changes: 7 additions & 0 deletions docs/admin/analytics.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,12 @@
# Analytics

<TierCallout>
Supported on [Enterprise](/pricing/enterprise) plans.
<user>
Available via the Web app.
</user>
</TierCallout>

The analytics section helps Sourcegraph administrators understand user engagement across the various Sourcegraph features, identify power users, and convey value to internal leaders. Introduced in version 3.42, the section includes analytics breakdowns for our most common features such as Batch Changes, Search Notebooks and search, while also providing basic user-level analytics.

## Data Visualizations
Expand Down
7 changes: 7 additions & 0 deletions docs/admin/auth/index.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,12 @@
# User authentication

<TierCallout>
Supported on [Enterprise](/pricing/enterprise) plans.
<user>
Available via the Web app.
</user>
</TierCallout>

In order to use a Sourcegraph instance, users need an account on the instance. Accounts are used to store settings and preferences, but also to identify a person to make decisions about repository visibility.

For that, various authentication providers can be configured. Multiple options can be provided.
Expand Down
7 changes: 7 additions & 0 deletions docs/admin/code_hosts/aws_codecommit.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,12 @@
# AWS CodeCommit

<TierCallout>
Supported on [Enterprise](/pricing/enterprise) plans.
<user>
Available via the Web app.
</user>
</TierCallout>

Site admins can sync Git repositories hosted on [AWS CodeCommit](https://aws.amazon.com/codecommit/) with Sourcegraph so that users can search and navigate the repositories.

To connect AWS CodeCommit to Sourcegraph:
Expand Down
7 changes: 7 additions & 0 deletions docs/admin/code_hosts/azuredevops.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,12 @@
# Azure DevOps

<TierCallout>
Supported on [Enterprise](/pricing/enterprise) plans.
<user>
Available via the Web app.
</user>
</TierCallout>

Site admins can sync Git repositories hosted on [Azure DevOps](https://dev.azure.com) with Sourcegraph so that users can search and navigate the repositories.

To connect Azure DevOps to Sourcegraph, create a personal access token from your user settings page by following the below steps:
Expand Down
7 changes: 7 additions & 0 deletions docs/admin/code_hosts/bitbucket_cloud.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,12 @@
# Bitbucket Cloud

<TierCallout>
Supported on [Enterprise](/pricing/enterprise) plans.
<user>
Available via the Web app.
</user>
</TierCallout>

Site admins can sync Git repositories hosted on [Bitbucket Cloud](https://bitbucket.org) with Sourcegraph so that users can search and navigate the repositories.

To connect Bitbucket Cloud to Sourcegraph:
Expand Down
9 changes: 8 additions & 1 deletion docs/admin/code_hosts/bitbucket_server.mdx
Original file line number Diff line number Diff line change
@@ -1,4 +1,11 @@
# Bitbucket Server / Bitbucket Data Center
# Bitbucket Server/Bitbucket Data Center

<TierCallout>
Supported on [Enterprise](/pricing/enterprise) plans.
<user>
Available via the Web app.
</user>
</TierCallout>

Site admins can sync Git repositories hosted on [Bitbucket Server](https://www.atlassian.com/software/bitbucket/server) or [Bitbucket Data Center](https://www.atlassian.com/enterprise/data-center/bitbucket) with Sourcegraph so that users can search and navigate their repositories.

Expand Down
12 changes: 10 additions & 2 deletions docs/admin/code_hosts/gerrit.mdx
Original file line number Diff line number Diff line change
@@ -1,15 +1,23 @@
# Gerrit

<Callout type="note">This feature is in beta and might change in the future.</Callout>
<TierCallout>
Supported on [Enterprise](/pricing/enterprise) plans.
<user>
Available via the Web app.
</user>
</TierCallout>

<Callout type="note">This feature is in beta and might change in the future.</Callout>

A Gerrit instance can be connected to Sourcegraph as follows:

- [Gerrit](#gerrit)
- [Configure Gerrit as a code host connection](#configure-gerrit-as-a-code-host-connection)
- [Clone using SSH](#clone-using-ssh)
- [Add Gerrit as an authentication provider](#add-gerrit-as-an-authentication-provider)
- [Have users authenticate their Sourcegraph accounts using their Gerrit HTTP credentials](#have-users-authenticate-their-sourcegraph-accounts-using-their-gerrit-http-credentials)
- [Configuration](#configuration)
- [admin/external\_service/gerrit.schema.json](#adminexternal_servicegerritschemajson)
- [admin/code\_hosts/gerrit.schema.json](#admincode_hostsgerritschemajson)

## Configure Gerrit as a code host connection

Expand Down
2 changes: 1 addition & 1 deletion docs/admin/code_hosts/github.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -110,7 +110,7 @@ Once public, App can be installed in additional namespaces either from Sourcegra
5. To sync repositories from this installation, click **Add connection** under your new installation.

### Configuring Multiple Private GitHub Apps for Sourcegraph
If you prefer not to make your GitHub App public and instead create separate private GitHub Apps for each organizations, users will need to authorize each GitHub App individually to ensure proper repository access and permissions syncing. This is because GitHub Apps have narrowly scoped permissions and do not share authentication across multiple installations. To streamline this process, users can go to `User Settings` > `Account Security` in Sourcegraph and connect all necessary GitHub Apps from there. Once authorized, Sourcegraph will use the user's GitHub identity to determine access across all configured GitHub Apps.
If you prefer not to make your GitHub App public and instead create separate private GitHub Apps for each organizations, users will need to authorize each GitHub App individually to ensure proper repository access and permissions syncing. This is because GitHub Apps have narrowly scoped permissions and do not share authentication across multiple installations. To streamline this process, users can go to `User Settings` > `Account Security` in Sourcegraph and connect all necessary GitHub Apps from there. Once authorized, Sourcegraph will use the user's GitHub identity to determine access across all configured GitHub Apps.

For customers using GitHub Enterprise Cloud, an alternative approach is to create an Enterprise GitHub App, which can be installed across multiple organizations within an enterprise account while maintaining private visibility. More details on this approach can be found in [GitHub's documentation](https://docs.github.com/en/enterprise-cloud@latest/admin/managing-your-enterprise-account/creating-github-apps-for-your-enterprise).

Expand Down
7 changes: 7 additions & 0 deletions docs/admin/code_hosts/gitolite.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,12 @@
# Gitolite

<TierCallout>
Supported on [Enterprise](/pricing/enterprise) plans.
<user>
Available via the Web app.
</user>
</TierCallout>

> NOTE: While it is possible to connect Gitolite repositories to Sourcegraph, we currently do not recommend it. If you have specific questions, please discuss with your account team.

Site admins can link and sync Git repositories on [Gitolite](https://gitolite.com) with Sourcegraph so that users can search and navigate the repositories.
Expand Down
7 changes: 7 additions & 0 deletions docs/admin/code_hosts/index.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,12 @@
# Code host connections

<TierCallout>
[Enterprise Starter](/pricing/enterprise-starter) only supports GitHub. [Enterprise](/pricing/enterprise) supports all listed code hosts.
<user>
Available via the Web app.
</user>
</TierCallout>

<Callout type="info">Sourcegraph Enterprise Starter supports only GitHub as a code host connection. Enterprise plan can connect to all supported code hosts listed on this page.</Callout>

Sourcegraph can sync repositories from code hosts and other similar services. We designate code hosts between Tier 1 and Tier 2 based on Sourcegraph's capabilities when used with those code hosts.
Expand Down
7 changes: 7 additions & 0 deletions docs/admin/code_hosts/non-git.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,12 @@
# Non-Git code hosts (Perforce, Mercurial, Subversion, raw text, etc.)

<TierCallout>
Supported on [Enterprise](/pricing/enterprise) plans.
<user>
Available via the Web app.
</user>
</TierCallout>

Sourcegraph natively supports all Git-based Version Control Systems (VCSs) and code hosts. For non-Git code hosts, Sourcegraph provides a CLI tool called `src-expose` to periodically sync and continuously serve local directories as Git repositories over HTTP.

>NOTE: If using Perforce, see the [Perforce repositories with Sourcegraph guide](/admin/repo/perforce).
Expand Down
7 changes: 7 additions & 0 deletions docs/admin/code_hosts/other.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,12 @@
# Other Git repository hosts

<TierCallout>
Supported on [Enterprise](/pricing/enterprise) plans.
<user>
Available via the Web app.
</user>
</TierCallout>

Site admins can sync Git repositories on any Git repository host (by Git clone URL) with Sourcegraph so that users can search and navigate the repositories. Use this method only when your repository host is not named as a supported [code host](/admin/code_hosts/).

To connect generic Git host to Sourcegraph:
Expand Down
7 changes: 7 additions & 0 deletions docs/admin/code_hosts/phabricator.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,12 @@
# Phabricator

<TierCallout>
Supported on [Enterprise](/pricing/enterprise) plans.
<user>
Available via the Web app.
</user>
</TierCallout>

Site admins can associate Git repositories on [Phabricator](https://phabricator.org) with Sourcegraph so that users can jump to the Phabricator repository from Sourcegraph and use the [Phabricator extension](#native-extension) and [browser extension](/integration/browser_extension) with Phabricator.

> ⚠️ NOTE: Sourcegraph support of Phabricator is limited ([learn more](/integration/phabricator)), and not expected to evolve due to the [announced](https://admin.phacility.com/phame/post/view/11/phacility_is_winding_down_operations/) cease of support for Phabricator.
Expand Down
7 changes: 7 additions & 0 deletions docs/admin/config/index.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,12 @@
# Configuring Sourcegraph

<TierCallout>
Supported on [Enterprise](/pricing/enterprise) plans.
<user>
Available via the Web app.
</user>
</TierCallout>

This page documents how to configure a Sourcegraph instance. For deployment configuration, please refer to the [relevant deployment docs for your deployment type](/admin/deploy/#deployment-types).

- [Site configuration](/admin/config/site_config)
Expand Down
7 changes: 7 additions & 0 deletions docs/admin/deploy/index.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,12 @@
# Deployment Overview

<TierCallout>
Supported on [Enterprise](/pricing/enterprise) plans.
<user>
Available via the Web app.
</user>
</TierCallout>

Sourcegraph is a powerful code intelligence platform that can be deployed in various ways to suit your organization's needs. This guide will help you understand the available deployment options and choose the best one for your use case.

## Deployment types
Expand Down
7 changes: 7 additions & 0 deletions docs/admin/executors/index.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,12 @@
# Executors

<TierCallout>
Supported on [Enterprise](/pricing/enterprise) plans.
<user>
Available via the Web app.
</user>
</TierCallout>

Executors are Sourcegraph's solution for running untrusted code in a secure and controllable way. Executors provide a sandbox that can run resource-intensive or untrusted tasks on behalf of the Sourcegraph instance, such as:

- [Automatically indexing a repository for precise code navigation](/code-search/code-navigation/auto_indexing)
Expand Down
7 changes: 7 additions & 0 deletions docs/admin/index.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,12 @@
# Administration

<TierCallout>
Supported on [Enterprise](/pricing/enterprise) plans.
<user>
Available via the Web app.
</user>
</TierCallout>

Sourcegraph administration is primarily managed by site administrators, who are responsible for the deployment, management, and configuration of Sourcegraph instances for end users. For a comprehensive introduction to site administration, refer to our [quickstart guide](/admin/how-to/site-admin-quickstart).


Expand Down
7 changes: 7 additions & 0 deletions docs/admin/licensing/index.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,12 @@
# Licensing

<TierCallout>
Supported on [Enterprise](/pricing/enterprise) plans.
<user>
Available via the Web app.
</user>
</TierCallout>

Sourcegraph requires a valid license key to enable many of its more prominent features.

License keys should not be shared across instances of Sourcegraph. If an additional license key is required for something like a dev environment, please [contact customer support](https://about.sourcegraph.com/contact) for an additional license key.
Expand Down
6 changes: 6 additions & 0 deletions docs/admin/observability/index.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,11 @@
# Observability

<TierCallout>
Supported on [Enterprise](/pricing/enterprise) plans.
<user>
Available via the Web app.
</user>
</TierCallout>

A key pillar of production readiness is the ability to observe, monitor, and analyze the health and state of the system.
Sourcegraph is designed, and ships with, a number of observability tools and capabilities to meet enterprise production readiness criteria.
Expand Down
7 changes: 7 additions & 0 deletions docs/admin/permissions/index.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,12 @@
# Permissions

<TierCallout>
Supported on [Enterprise](/pricing/enterprise) plans.
<user>
Available via the Web app.
</user>
</TierCallout>

> NOTE: This page refers to repository access permissions synced between Sourcegraph and your code host, which has also historically been referred to as "authorization", "repository permissions", and "code host permissions". This is *not* the same as [in-product permissions](/admin/access_control/), which determine who can, for example, create a batch change or who is a site admin.

Sourcegraph can be configured to enforce the same access to repositories and underlying
Expand Down
9 changes: 8 additions & 1 deletion docs/admin/updates/index.mdx
Original file line number Diff line number Diff line change
@@ -1,4 +1,11 @@
# Updating sourcegraph
# Updating Sourcegraph

<TierCallout>
Supported on [Enterprise](/pricing/enterprise) plans.
<user>
Available via the Web app.
</user>
</TierCallout>

This page is intended as an entry point into Sourcegraph versioning, upgrades, and the `migrator` service which manages our database schemas. Here we'll cover general concepts and direct you toward relevant operations pages.

Expand Down