Skip to content
Open
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
2 changes: 1 addition & 1 deletion docs/admin/code-hosts/aws-codecommit.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ AWS CodeCommit connections support the following configuration options, which ar

{/* SCHEMA_SYNC_START: admin/code_hosts/aws_codecommit.schema.json */}
{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
{/* Last updated: 2026-09-08T17:20:44Z */}
{/* Last updated: 2026-09-11T16:59:01Z */}
```json
{
// REQUIRED:
Expand Down
2 changes: 1 addition & 1 deletion docs/admin/code-hosts/azuredevops.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,7 @@ Azure DevOps connections support the following configuration options, which are

{/* SCHEMA_SYNC_START: admin/code_hosts/azuredevops.schema.json */}
{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
{/* Last updated: 2026-09-08T17:20:44Z */}
{/* Last updated: 2026-09-11T16:59:01Z */}
```json
// Authentication alternatives: token OR windowsPassword

Expand Down
2 changes: 1 addition & 1 deletion docs/admin/code-hosts/bitbucket-cloud.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -116,7 +116,7 @@ Bitbucket Cloud connections support the following configuration options, which a

{/* SCHEMA_SYNC_START: admin/code_hosts/bitbucket_cloud.schema.json */}
{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
{/* Last updated: 2026-09-08T17:20:44Z */}
{/* Last updated: 2026-09-11T16:59:01Z */}
```json
{
// The workspace access token to use when authenticating with Bitbucket Cloud.
Expand Down
2 changes: 1 addition & 1 deletion docs/admin/code-hosts/bitbucket-server.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -202,7 +202,7 @@ Bitbucket Server / Bitbucket Data Center connections support the following confi

{/* SCHEMA_SYNC_START: admin/code_hosts/bitbucket_server.schema.json */}
{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
{/* Last updated: 2026-09-08T17:20:44Z */}
{/* Last updated: 2026-09-11T16:59:01Z */}
```json
// Authentication alternatives: token OR password

Expand Down
2 changes: 1 addition & 1 deletion docs/admin/code-hosts/gerrit.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -113,7 +113,7 @@ Gerrit connections support the following configuration options, which are specif

{/* SCHEMA_SYNC_START: admin/code_hosts/gerrit.schema.json */}
{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
{/* Last updated: 2026-09-08T17:20:44Z */}
{/* Last updated: 2026-09-11T16:59:01Z */}
```json
{
// If non-null, enforces Gerrit repository permissions. This requires that there is an item in the [site configuration json](https://sourcegraph.com/docs/admin/config/site_config#auth-providers) `auth.providers` field, of type "gerrit" with the same `url` field as specified in this `GerritConnection`.
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 @@ -458,7 +458,7 @@ GitHub connections support the following configuration options, which are specif

{/* SCHEMA_SYNC_START: admin/code_hosts/github.schema.json */}
{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
{/* Last updated: 2026-09-08T17:20:44Z */}
{/* Last updated: 2026-09-11T16:59:01Z */}
```json
// Authentication alternatives: token OR gitHubAppDetails OR externalAccount OR useRandomExternalAccount

Expand Down
2 changes: 1 addition & 1 deletion docs/admin/code-hosts/gitlab.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -189,7 +189,7 @@ See [Internal rate limits](/admin/code-hosts/rate-limits#internal-rate-limits).

{/* SCHEMA_SYNC_START: admin/code_hosts/gitlab.schema.json */}
{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
{/* Last updated: 2026-09-08T17:20:44Z */}
{/* Last updated: 2026-09-11T16:59:01Z */}
```json
{
// If non-null, enforces GitLab repository permissions. This requires that there be an item in the `auth.providers` field of type "gitlab" with the same `url` field as specified in this `GitLabConnection`.
Expand Down
2 changes: 1 addition & 1 deletion docs/admin/code-hosts/gitolite.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ To connect Gitolite to Sourcegraph:

{/* SCHEMA_SYNC_START: admin/code_hosts/gitolite.schema.json */}
{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
{/* Last updated: 2026-09-08T17:20:44Z */}
{/* Last updated: 2026-09-11T16:59:01Z */}
```json
{
// A list of repositories to never mirror from this Gitolite instance. Supports excluding by exact name ({"name": "foo"}).
Expand Down
2 changes: 1 addition & 1 deletion docs/admin/code-hosts/other.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -68,7 +68,7 @@ Repositories must be listed individually:

{/* SCHEMA_SYNC_START: admin/code_hosts/other_external_service.schema.json */}
{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
{/* Last updated: 2026-09-08T17:20:44Z */}
{/* Last updated: 2026-09-11T16:59:01Z */}
```json
{
// A list of repositories to never mirror by name after applying repositoryPathPattern. Supports excluding by exact name ({"name": "myrepo"}) or regular expression ({"pattern": ".*secret.*"}).
Expand Down
2 changes: 1 addition & 1 deletion docs/admin/code-hosts/phabricator.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -76,7 +76,7 @@ The Sourcegraph instance's site admin must [update the `corsOrigin` site config

{/* SCHEMA_SYNC_START: admin/code_hosts/phabricator.schema.json */}
{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
{/* Last updated: 2026-09-08T17:20:44Z */}
{/* Last updated: 2026-09-11T16:59:01Z */}
```json
{
// SSH cipher to use when cloning via SSH. Must be a valid choice from `ssh -Q cipher`.
Expand Down
2 changes: 1 addition & 1 deletion docs/admin/config/settings.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ Settings options and their default values are shown below.

{/* SCHEMA_SYNC_START: admin/config/settings.schema.json */}
{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
{/* Last updated: 2026-09-08T17:20:44Z */}
{/* Last updated: 2026-09-11T16:59:01Z */}
```json
{

Expand Down
16 changes: 8 additions & 8 deletions docs/admin/config/site-config.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ All site configuration options and their default values are shown below.

{/* SCHEMA_SYNC_START: admin/config/site.schema.json */}
{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
{/* Last updated: 2026-09-08T17:20:44Z */}
{/* Last updated: 2026-09-11T16:59:01Z */}
```json
{

Expand All @@ -45,8 +45,8 @@ All site configuration options and their default values are shown below.
// Valid options: "permissive", "enforced"
"attribution.mode": "permissive",

// Enables/disables Agentic Batch Changes. Before September 14, 2026 at 12:00 UTC, the feature is disabled when unset. At and after that time, the feature is enabled when unset. An explicit value overrides the timed default. Agentic Batch Changes are enabled only if Batch Changes is licensed and the license includes AI Terms 2025.
"batchChanges.agenticBatchChanges.enabled": false,
// Enables/disables Agentic Batch Changes. Enabled by default. Agentic Batch Changes are enabled only if Batch Changes is licensed and the license includes AI Terms 2025.
"batchChanges.agenticBatchChanges.enabled": true,

// Automatically delete branches created for Batch Changes changesets when the changeset is merged or closed, for supported code hosts. Overrides any setting on the repository on the code host itself.
"batchChanges.autoDeleteBranch": false,
Expand Down Expand Up @@ -419,7 +419,7 @@ All site configuration options and their default values are shown below.
// Number of concurrent executions of a code insight query on a worker node
// Other example values:
// - 10
"insights.query.worker.concurrency": 1,
"insights.query.worker.concurrency": 5,

// Maximum number of Code Insights queries initiated per second on a worker node.
// Other example values:
Expand Down Expand Up @@ -530,7 +530,7 @@ All site configuration options and their default values are shown below.
// Don't sync a repo's permissions if it has synced within the last n seconds.
"permissions.syncReposBackoffSeconds": 900,

// The maximum number of repo-centric permissions syncing jobs that can be spawned concurrently. Service restart is required to take effect for changes.
// The maximum number of repo-centric permissions syncing jobs that can be spawned concurrently.
"permissions.syncReposMaxConcurrency": 5,

// Time interval (in seconds) of how often each component picks up authorization changes in external services.
Expand All @@ -539,7 +539,7 @@ All site configuration options and their default values are shown below.
// Don't sync a user's permissions if they have synced within the last n seconds.
"permissions.syncUsersBackoffSeconds": 900,

// The maximum number of user-centric permissions syncing jobs that can be spawned concurrently. Service restart is required to take effect for changes.
// The maximum number of user-centric permissions syncing jobs that can be spawned concurrently.
"permissions.syncUsersMaxConcurrency": 5,

// Settings for Sourcegraph explicit permissions, which allow the site admin to explicitly manage repository permissions via the GraphQL API. This will mark repositories as restricted by default.
Expand Down Expand Up @@ -1016,10 +1016,10 @@ All site configuration options and their default values are shown below.
// Maximum number of git operations (e.g. clone or ls-remote) to be run against code hosts, per second. Fractional rates are rounded to the nearest hourly quota, with positive rates below that resolution enforced as one request per hour. Rate limit is shared across all instances of gitserver, and all code hosts. Default is -1, which is unlimited.
"gitMaxCodehostRequestsPerSecond": -1,

// Maximum number of git clone processes that will be run concurrently per gitserver to update repositories. <= 0 means disabled.
// Maximum number of repository cleanup jobs that can run concurrently. Values less than or equal to 0 disable cleanup without interrupting jobs that are already running.
"gitMaxConcurrentCleanups": 5,

// Maximum number of git clone processes that will be run concurrently per gitserver to update repositories. Note: the global git update scheduler respects gitMaxConcurrentClones. Changes to this setting require restarting the worker instance (the worker pod in Kubernetes) before the global scheduler uses the new value. However, we allow each gitserver to run up to gitMaxConcurrentClones to allow for urgent fetches. Urgent fetches are used when a user is browsing a PR and we do not have the commit yet.
// Maximum number of git clone processes that will be run concurrently per gitserver to update repositories. Note: the global git update scheduler respects gitMaxConcurrentClones. We allow each gitserver to run up to gitMaxConcurrentClones to allow for urgent fetches. Urgent fetches are used when a user is browsing a PR and we do not have the commit yet.
"gitMaxConcurrentClones": 5,

// Record git operations that are executed on configured repositories.
Expand Down
2 changes: 1 addition & 1 deletion docs/admin/repo/perforce.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -228,7 +228,7 @@ With this setting, Sourcegraph will ignore any rules with a host other than `*`,

{/* SCHEMA_SYNC_START: admin/code_hosts/perforce.schema.json */}
{/* WARNING: This section is auto-generated during releases. Do not edit manually. */}
{/* Last updated: 2026-09-08T17:20:44Z */}
{/* Last updated: 2026-09-11T16:59:01Z */}
```json
{
// If non-null, enforces Perforce depot permissions.
Expand Down
4 changes: 2 additions & 2 deletions docs/admin/telemetry/private-metadata-allowlist.mdx
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
# Private metadata allowlist

This document lists all telemetry events that are allowed to export specific `privateMetadata` fields (from within [telemetry event parameters](/admin/telemetry/protocol#telemetrygateway-v1-EventParameters)).
This document lists all telemetry events that are allowed to export specific `privateMetadata` fields (from within [telemetry event parameters](https://sourcegraph.com/docs/admin/telemetry/protocol#telemetrygateway-v1-EventParameters)).

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • https://sourcegraph.com/docs/admin/telemetry/protocol#telemetrygateway-v1-EventParameters: Absolute self-link; use "/admin/telemetry/protocol#telemetrygateway-v1-EventParameters" instead
Suggested change
This document lists all telemetry events that are allowed to export specific `privateMetadata` fields (from within [telemetry event parameters](https://sourcegraph.com/docs/admin/telemetry/protocol#telemetrygateway-v1-EventParameters)).
This document lists all telemetry events that are allowed to export specific `privateMetadata` fields (from within [telemetry event parameters](/admin/telemetry/protocol#telemetrygateway-v1-EventParameters)).

By default, `privateMetadata` is **never** exported from customers because it can contain arbitrarily-shaped data that may accidentally include sensitive or private contents.
The specific events and properties listed below have been individually reviewed and approved for export.
The implementation of each is monitored to ensure they contain only categorized, enumerated information.

The only `metadata` we collect by default are non-sensitive numeric values.
To learn more, refer to the [telemetry documentation](/admin/telemetry).
To learn more, refer to the [telemetry documentation](https://sourcegraph.com/docs/admin/telemetry).

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • https://sourcegraph.com/docs/admin/telemetry: Absolute self-link; use "/admin/telemetry" instead
Suggested change
To learn more, refer to the [telemetry documentation](https://sourcegraph.com/docs/admin/telemetry).
To learn more, refer to the [telemetry documentation](/admin/telemetry).


| **Event feature** | **Event action** | **Allowed `privateMetadata` fields** |
| :---------------- | :--------------- | :----------------------------------- |
Expand Down
2 changes: 1 addition & 1 deletion docs/admin/telemetry/protocol.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@

This page contains the core schema for telemetry event data that gets exported from Sourcegraph.

To learn more, refer to our [telemetry documentation](/admin/telemetry).
To learn more, refer to our [telemetry documentation](https://sourcegraph.com/docs/admin/telemetry).

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • https://sourcegraph.com/docs/admin/telemetry: Absolute self-link; use "/admin/telemetry" instead
Suggested change
To learn more, refer to our [telemetry documentation](https://sourcegraph.com/docs/admin/telemetry).
To learn more, refer to our [telemetry documentation](/admin/telemetry).


## Table of Contents

Expand Down
27 changes: 27 additions & 0 deletions docs/cli/references/debug.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
# `src debug`



## Usage

```
'src debug' gathers and bundles debug data from a Sourcegraph deployment for troubleshooting.

Usage:

src debug command [command options]

The commands are:

kube dumps context from k8s deployments
compose dumps context from docker-compose deployments
server dumps context from single-container deployments


Use "src debug command -h" for more information about a subcommands.
src debug has access to flags on src -- Ex: src -v kube -o foo.zip



```

11 changes: 0 additions & 11 deletions docs/cli/references/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,20 +6,9 @@
* [`abc`](references/abc)
* [`api`](references/api)
* [`auth`](references/auth)
* [`batch`](references/batch)
* [`code-intel`](references/code-intel)
* [`codeowners`](references/codeowners)
* [`config`](references/config)
* [`debug`](references/debug)
* [`extsvc`](references/extsvc)
* [`login`](references/login)
* [`lsp`](references/lsp)
* [`orgs`](references/orgs)
* [`repos`](references/repos)
* [`search`](references/search)
* [`search-jobs`](references/search-jobs)
* [`serve-git`](references/serve-git)
* [`snapshot`](references/snapshot)
* [`users`](references/users)
* [`version`](references/version)

33 changes: 33 additions & 0 deletions docs/cli/references/search-jobs.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
# `src search-jobs`



## Usage

```
'src search-jobs' is a tool that manages search jobs on a Sourcegraph instance.

Usage:

src search-jobs command [command options]

The commands are:

cancel cancels a search job by ID
create creates a search job
delete deletes a search job by ID
get gets a search job by ID
list lists search jobs
logs fetches logs for a search job by ID
restart restarts a search job by ID
results fetches results for a search job by ID

Common options for all commands:
-c Select columns to display (e.g., -c id,query,state,username)
-json Output results in JSON format

Use "src search-jobs [command] -h" for more information about a command.


```

27 changes: 27 additions & 0 deletions docs/cli/references/snapshot.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
# `src snapshot`



## Usage

```
'src snapshot' manages snapshots of Sourcegraph instance databases. All subcommands are currently EXPERIMENTAL.

Usage:

src snapshot <command>

The commands are:

databases export databases from a Sourcegraph instance
restore restore databases from an export
upload upload exported databases and summary file when migrating to Sourcegraph Cloud

summary export summary data about an instance for acceptance testing of a restored Sourcegraph instance
test use exported summary data and instance health indicators to validate a restored and upgraded instance

Use "src snapshot [command] -h" for more information about a command.


```

26 changes: 26 additions & 0 deletions docs/cli/references/teams.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
# `src teams`



## Usage

```
'src teams' is a tool that manages teams in a Sourcegraph instance.

Usage:

src teams command [command options]

The commands are:

list lists teams
create create a team
update update a team
delete delete a team
members manage team members, use "src teams members [command] -h" for more information.

Use "src teams [command] -h" for more information about a command.


```

Loading
Loading