From 37d2c9f891ebd9708b68ce74ae20675400b9ec62 Mon Sep 17 00:00:00 2001 From: Robert Lin Date: Tue, 3 Nov 2026 00:10:11 +0000 Subject: [PATCH 1/9] docs: document dedicated Sourcegraph services gateway proxy Describe frontend-distributed gateway proxy configuration and process-local proxy behavior. Refs sourcegraph/sourcegraph#17104 Amp-Thread-ID: https://ampcode.com/threads/T-01a19e7e-3391-7202-84d2-f3c8e1b70413 Co-authored-by: Amp --- docs/self-hosted/private-network.mdx | 33 +++++++++++++++++++++++++++- 1 file changed, 32 insertions(+), 1 deletion(-) diff --git a/docs/self-hosted/private-network.mdx b/docs/self-hosted/private-network.mdx index 4ee09a498..6ef4abf1c 100644 --- a/docs/self-hosted/private-network.mdx +++ b/docs/self-hosted/private-network.mdx @@ -32,7 +32,38 @@ To ensure a smooth experience, instances must allow **outbound TCP port `443` to ## HTTP proxy configuration -Sourcegraph services use the conventional `HTTP_PROXY`, `HTTPS_PROXY`, and `NO_PROXY` environment variables. Set them on the `frontend` and `worker` services, using the example override file for your deployment method: +### Dedicated proxy for Sourcegraph services + +Set `SERVICES_GATEWAY_PROXY` to route pings, telemetry, and licensing traffic through a dedicated proxy, independently of code-host traffic and model inference. This applies to the clients described in [outbound access to Sourcegraph services](#outbound-access-to-sourcegraph-services), including their endpoint overrides. + +1. Set the following environment variable on **every `frontend` replica**, with the same value on each replica: + + ```sh + SERVICES_GATEWAY_PROXY=http://proxy.example.com:3128 + ``` + +2. Restart the `frontend` replicas. Frontend validates the URL and distributes it to consumers through `ServiceConnections`, not site configuration. Do not set this variable on other services: consumers ignore their local `SERVICES_GATEWAY_PROXY` and use the value distributed by frontend. +3. Expect consuming services to restart when the distributed value changes, including when you remove the proxy or change its credentials. Consumers exit so their process supervisor can restart them and recreate cached HTTP clients and gRPC connections with the updated route. + +The dedicated proxy supports **HTTP CONNECT**, with optional Basic authentication in the URL, for example `http://username:password@proxy.example.com:3128`. URL-encode special characters in credentials. Use an `http://` proxy URL with no query or fragment and no path other than an optional trailing slash. HTTPS-to-proxy and SOCKS proxies are not supported. + +HTTPS and gRPC connections retain TLS to the destination through the CONNECT tunnel. The connection to the proxy itself is not TLS-encrypted, so protect that network path, especially when using Basic authentication. The proxy must allow CONNECT to the destination and carry HTTP/2 gRPC traffic through the tunnel. + +`SERVICES_GATEWAY_PROXY` takes precedence over all [standard proxy settings](#standard-process-local-proxy-settings), including `NO_PROXY`, for these clients. This also applies to endpoint overrides, including localhost overrides. If the proxy is unreachable or rejects a connection, the request fails; it does not fall back to a direct connection. Other outbound clients do not use this dedicated proxy. + +### Standard process-local proxy settings + +When `SERVICES_GATEWAY_PROXY` is unset or empty, gateway clients use standard Go HTTP/gRPC proxy selection from the environment of **each process making the request**: + +- `HTTPS_PROXY` selects a proxy for HTTPS requests and gRPC connections. Its value can be an `http://` URL for an HTTP CONNECT proxy. +- `HTTP_PROXY` selects a proxy for HTTP requests. Setting it alone does **not** proxy HTTPS or gRPC traffic. +- `NO_PROXY` excludes matching destinations from standard proxy routing. + +The lowercase forms (`https_proxy`, `http_proxy`, and `no_proxy`) are also supported; the uppercase value takes precedence when both are set. These variables are process-local and are not distributed by frontend. Set them on each service that needs them, including `frontend` and `worker`, and restart the affected services after changes. + +Without the dedicated proxy, gateway HTTP clients use the internal HTTP client for endpoint hostnames `localhost` and `127.0.0.1`, including pings endpoint overrides. Standard proxy selection also retains Go/gRPC's localhost and loopback exclusions; do not rely on `HTTPS_PROXY` to proxy those destinations. + +Use the example override file for your deployment method to configure standard proxy variables: - [Kubernetes Helm](https://github.com/sourcegraph/deploy-sourcegraph-helm/blob/main/charts/sourcegraph/examples/outbound-http-proxy/override.yaml) - [Docker Compose](https://github.com/sourcegraph/deploy-sourcegraph-docker/blob/main/docker-compose/examples/outbound-http-proxy/docker-compose.override.yaml) From b6a0dc1773eb9d5eca7eae6d07dbdc449187f544 Mon Sep 17 00:00:00 2001 From: Robert Lin Date: Mon, 16 Nov 2026 20:38:27 +0000 Subject: [PATCH 2/9] Tighten services gateway proxy docs Amp-Thread-ID: https://ampcode.com/threads/T-9a5ed1e5-6bb8-4d58-b173-d5a8aa69a93b Co-authored-by: Amp --- docs/self-hosted/private-network.mdx | 42 ++++++++++------------------ 1 file changed, 14 insertions(+), 28 deletions(-) diff --git a/docs/self-hosted/private-network.mdx b/docs/self-hosted/private-network.mdx index 6ef4abf1c..2004c64bc 100644 --- a/docs/self-hosted/private-network.mdx +++ b/docs/self-hosted/private-network.mdx @@ -32,41 +32,27 @@ To ensure a smooth experience, instances must allow **outbound TCP port `443` to ## HTTP proxy configuration -### Dedicated proxy for Sourcegraph services - -Set `SERVICES_GATEWAY_PROXY` to route pings, telemetry, and licensing traffic through a dedicated proxy, independently of code-host traffic and model inference. This applies to the clients described in [outbound access to Sourcegraph services](#outbound-access-to-sourcegraph-services), including their endpoint overrides. - -1. Set the following environment variable on **every `frontend` replica**, with the same value on each replica: - - ```sh - SERVICES_GATEWAY_PROXY=http://proxy.example.com:3128 - ``` - -2. Restart the `frontend` replicas. Frontend validates the URL and distributes it to consumers through `ServiceConnections`, not site configuration. Do not set this variable on other services: consumers ignore their local `SERVICES_GATEWAY_PROXY` and use the value distributed by frontend. -3. Expect consuming services to restart when the distributed value changes, including when you remove the proxy or change its credentials. Consumers exit so their process supervisor can restart them and recreate cached HTTP clients and gRPC connections with the updated route. - -The dedicated proxy supports **HTTP CONNECT**, with optional Basic authentication in the URL, for example `http://username:password@proxy.example.com:3128`. URL-encode special characters in credentials. Use an `http://` proxy URL with no query or fragment and no path other than an optional trailing slash. HTTPS-to-proxy and SOCKS proxies are not supported. - -HTTPS and gRPC connections retain TLS to the destination through the CONNECT tunnel. The connection to the proxy itself is not TLS-encrypted, so protect that network path, especially when using Basic authentication. The proxy must allow CONNECT to the destination and carry HTTP/2 gRPC traffic through the tunnel. +Sourcegraph services use the conventional `HTTP_PROXY`, `HTTPS_PROXY`, and `NO_PROXY` environment variables. Set them on the `frontend` and `worker` services, using the example override file for your deployment method: -`SERVICES_GATEWAY_PROXY` takes precedence over all [standard proxy settings](#standard-process-local-proxy-settings), including `NO_PROXY`, for these clients. This also applies to endpoint overrides, including localhost overrides. If the proxy is unreachable or rejects a connection, the request fails; it does not fall back to a direct connection. Other outbound clients do not use this dedicated proxy. - -### Standard process-local proxy settings +- [Kubernetes Helm](https://github.com/sourcegraph/deploy-sourcegraph-helm/blob/main/charts/sourcegraph/examples/outbound-http-proxy/override.yaml) +- [Docker Compose](https://github.com/sourcegraph/deploy-sourcegraph-docker/blob/main/docker-compose/examples/outbound-http-proxy/docker-compose.override.yaml) -When `SERVICES_GATEWAY_PROXY` is unset or empty, gateway clients use standard Go HTTP/gRPC proxy selection from the environment of **each process making the request**: +`HTTP_PROXY` alone does not proxy HTTPS or gRPC traffic. Requests to `localhost` and loopback addresses are not proxied. -- `HTTPS_PROXY` selects a proxy for HTTPS requests and gRPC connections. Its value can be an `http://` URL for an HTTP CONNECT proxy. -- `HTTP_PROXY` selects a proxy for HTTP requests. Setting it alone does **not** proxy HTTPS or gRPC traffic. -- `NO_PROXY` excludes matching destinations from standard proxy routing. +### Dedicated proxy for Sourcegraph services -The lowercase forms (`https_proxy`, `http_proxy`, and `no_proxy`) are also supported; the uppercase value takes precedence when both are set. These variables are process-local and are not distributed by frontend. Set them on each service that needs them, including `frontend` and `worker`, and restart the affected services after changes. +To route traffic to [Sourcegraph services](#outbound-access-to-sourcegraph-services) through a separate proxy, set `SERVICES_GATEWAY_PROXY` to the same value on every `frontend` replica, then restart them: -Without the dedicated proxy, gateway HTTP clients use the internal HTTP client for endpoint hostnames `localhost` and `127.0.0.1`, including pings endpoint overrides. Standard proxy selection also retains Go/gRPC's localhost and loopback exclusions; do not rely on `HTTPS_PROXY` to proxy those destinations. +```sh +SERVICES_GATEWAY_PROXY=http://username:password@proxy.example.com:3128 +``` -Use the example override file for your deployment method to configure standard proxy variables: +Do not set it on other services: they receive the value from `frontend` and restart when it changes. -- [Kubernetes Helm](https://github.com/sourcegraph/deploy-sourcegraph-helm/blob/main/charts/sourcegraph/examples/outbound-http-proxy/override.yaml) -- [Docker Compose](https://github.com/sourcegraph/deploy-sourcegraph-docker/blob/main/docker-compose/examples/outbound-http-proxy/docker-compose.override.yaml) +- Only `http://` proxies that support HTTP CONNECT are supported. Basic authentication is optional; URL-encode special characters in credentials. +- TLS to the destination is preserved, but the connection to the proxy is not encrypted. +- It takes precedence over `HTTPS_PROXY` and `NO_PROXY`, including for `localhost` endpoint overrides. +- If the proxy is unreachable, requests fail instead of connecting directly. ## Docker networking configuration From 7b5238927b8c3a1fff1b4246f1c658c9157e5045 Mon Sep 17 00:00:00 2001 From: Robert Lin Date: Mon, 16 Nov 2026 20:55:59 +0000 Subject: [PATCH 3/9] Call them Sourcegraph managed services Amp-Thread-ID: https://ampcode.com/threads/T-9a5ed1e5-6bb8-4d58-b173-d5a8aa69a93b Co-authored-by: Amp --- docs/self-hosted/private-network.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/self-hosted/private-network.mdx b/docs/self-hosted/private-network.mdx index 2004c64bc..91f3d6db0 100644 --- a/docs/self-hosted/private-network.mdx +++ b/docs/self-hosted/private-network.mdx @@ -39,9 +39,9 @@ Sourcegraph services use the conventional `HTTP_PROXY`, `HTTPS_PROXY`, and `NO_P `HTTP_PROXY` alone does not proxy HTTPS or gRPC traffic. Requests to `localhost` and loopback addresses are not proxied. -### Dedicated proxy for Sourcegraph services +### Dedicated proxy for Sourcegraph managed services -To route traffic to [Sourcegraph services](#outbound-access-to-sourcegraph-services) through a separate proxy, set `SERVICES_GATEWAY_PROXY` to the same value on every `frontend` replica, then restart them: +To route traffic to [Sourcegraph managed services](#outbound-access-to-sourcegraph-services) through a separate proxy, set `SERVICES_GATEWAY_PROXY` to the same value on every `frontend` replica, then restart them: ```sh SERVICES_GATEWAY_PROXY=http://username:password@proxy.example.com:3128 From 745a44d624e47d01eca10cddd65087f65f92d480 Mon Sep 17 00:00:00 2001 From: Robert Lin Date: Mon, 16 Nov 2026 20:56:23 +0000 Subject: [PATCH 4/9] Rename to Sourcegraph managed services Amp-Thread-ID: https://ampcode.com/threads/T-9a5ed1e5-6bb8-4d58-b173-d5a8aa69a93b Co-authored-by: Amp --- docs/admin/architecture.mdx | 2 +- docs/admin/enterprise-portal.mdx | 2 +- docs/admin/pings.mdx | 2 +- docs/admin/telemetry/index.mdx | 2 +- docs/self-hosted/private-network.mdx | 6 ++++-- 5 files changed, 8 insertions(+), 6 deletions(-) diff --git a/docs/admin/architecture.mdx b/docs/admin/architecture.mdx index 1f9cd017a..4bd99bbcb 100644 --- a/docs/admin/architecture.mdx +++ b/docs/admin/architecture.mdx @@ -298,7 +298,7 @@ flowchart LR click ModelProvider "#model-provider" ``` -For the services gateway's IP address, required ports and protocols, and firewall and proxy configuration, see [outbound access to Sourcegraph services](/self-hosted/private-network#outbound-access-to-sourcegraph-services). Other enabled features and integrations may require additional external destinations. +For the services gateway's IP address, required ports and protocols, and firewall and proxy configuration, see [outbound access to Sourcegraph managed services](/self-hosted/private-network#outbound-access-to-sourcegraph-managed-services). Other enabled features and integrations may require additional external destinations. ### Model Provider diff --git a/docs/admin/enterprise-portal.mdx b/docs/admin/enterprise-portal.mdx index 30f05dc69..c0c9237f8 100644 --- a/docs/admin/enterprise-portal.mdx +++ b/docs/admin/enterprise-portal.mdx @@ -37,7 +37,7 @@ Subscription admins can view [Sourcegraph Analytics](/analytics) for the subscri Subscription admins can view credit balances and rates for metered services, including [Deep Search](/deep-search) and [Agentic Batch Changes](/agentic-batch-changes), on the **Credits** page. This replaces the former Deep Search usage monitoring page and shows subscription-wide consumption, not an individual user's usage. -Self-hosted instances need outbound connectivity to Enterprise Portal through the services gateway for credit/quota checks and consumption reporting. Before using metered services, configure the [required outbound access](/self-hosted/private-network#outbound-access-to-sourcegraph-services), including IP allowlisting if your network restricts egress. +Self-hosted instances need outbound connectivity to Enterprise Portal through the services gateway for credit/quota checks and consumption reporting. Before using metered services, configure the [required outbound access](/self-hosted/private-network#outbound-access-to-sourcegraph-managed-services), including IP allowlisting if your network restricts egress. 1. [Sign in to Enterprise Portal](#accessing-sourcegraph-enterprise-portal) as a subscription admin. 2. Select your subscription. diff --git a/docs/admin/pings.mdx b/docs/admin/pings.mdx index 04c3ded56..23569164c 100644 --- a/docs/admin/pings.mdx +++ b/docs/admin/pings.mdx @@ -202,7 +202,7 @@ Sourcegraph aggregates usage and performance metrics for some product features i ## Allowlist IPs / CIDR Ranges for Sourcegraph -Refer to [outbound access to Sourcegraph services](/self-hosted/private-network#outbound-access-to-sourcegraph-services) for the destinations, ports, and protocols to allow. +Refer to [outbound access to Sourcegraph managed services](/self-hosted/private-network#outbound-access-to-sourcegraph-managed-services) for the destinations, ports, and protocols to allow. ## Using an HTTP proxy for ping requests diff --git a/docs/admin/telemetry/index.mdx b/docs/admin/telemetry/index.mdx index 91453fbaa..76971e089 100644 --- a/docs/admin/telemetry/index.mdx +++ b/docs/admin/telemetry/index.mdx @@ -47,7 +47,7 @@ You can reach out to support@sourcegraph.com for additional information about ho ## Allowlist IPs / CIDR ranges for Sourcegraph -See [outbound access to Sourcegraph services](/self-hosted/private-network#outbound-access-to-sourcegraph-services) for the services gateway's IP, hostname, and protocol requirements. +See [outbound access to Sourcegraph managed services](/self-hosted/private-network#outbound-access-to-sourcegraph-managed-services) for the services gateway's IP, hostname, and protocol requirements. ## Architecture diff --git a/docs/self-hosted/private-network.mdx b/docs/self-hosted/private-network.mdx index 91f3d6db0..598c6fef9 100644 --- a/docs/self-hosted/private-network.mdx +++ b/docs/self-hosted/private-network.mdx @@ -24,7 +24,9 @@ The following [Sourcegraph services](/admin/architecture) initiate outbound conn - **worker**: Sourcegraph Worker background jobs that may require establishing connections to services hosted within an organization's private network -## Outbound access to Sourcegraph services + + +## Outbound access to Sourcegraph managed services Sourcegraph makes requests to `https://services.sourcegraph.com` for [key product capabilities](/admin/architecture#connections-to-sourcegraph-managed-services). @@ -41,7 +43,7 @@ Sourcegraph services use the conventional `HTTP_PROXY`, `HTTPS_PROXY`, and `NO_P ### Dedicated proxy for Sourcegraph managed services -To route traffic to [Sourcegraph managed services](#outbound-access-to-sourcegraph-services) through a separate proxy, set `SERVICES_GATEWAY_PROXY` to the same value on every `frontend` replica, then restart them: +To route traffic to [Sourcegraph managed services](#outbound-access-to-sourcegraph-managed-services) through a separate proxy, set `SERVICES_GATEWAY_PROXY` to the same value on every `frontend` replica, then restart them: ```sh SERVICES_GATEWAY_PROXY=http://username:password@proxy.example.com:3128 From 2b530239a1129abaaccb4f8bb2ab124fe9bc8e9d Mon Sep 17 00:00:00 2001 From: Robert Lin Date: Mon, 16 Nov 2026 20:58:06 +0000 Subject: [PATCH 5/9] Move dedicated proxy under outbound access Amp-Thread-ID: https://ampcode.com/threads/T-9a5ed1e5-6bb8-4d58-b173-d5a8aa69a93b Co-authored-by: Amp --- docs/self-hosted/private-network.mdx | 26 ++++++++++++++------------ 1 file changed, 14 insertions(+), 12 deletions(-) diff --git a/docs/self-hosted/private-network.mdx b/docs/self-hosted/private-network.mdx index 598c6fef9..ec8d3b577 100644 --- a/docs/self-hosted/private-network.mdx +++ b/docs/self-hosted/private-network.mdx @@ -32,18 +32,9 @@ Sourcegraph makes requests to `https://services.sourcegraph.com` for [key produc To ensure a smooth experience, instances must allow **outbound TCP port `443` to `34.36.231.254`**, with **HTTPS and HTTP/2 gRPC** support through your firewall or proxy. For hostname-based filtering, allow `services.sourcegraph.com`. Keep the hostname for TLS; do not replace it with the IP address. No inbound firewall rule is required. -## HTTP proxy configuration - -Sourcegraph services use the conventional `HTTP_PROXY`, `HTTPS_PROXY`, and `NO_PROXY` environment variables. Set them on the `frontend` and `worker` services, using the example override file for your deployment method: - -- [Kubernetes Helm](https://github.com/sourcegraph/deploy-sourcegraph-helm/blob/main/charts/sourcegraph/examples/outbound-http-proxy/override.yaml) -- [Docker Compose](https://github.com/sourcegraph/deploy-sourcegraph-docker/blob/main/docker-compose/examples/outbound-http-proxy/docker-compose.override.yaml) - -`HTTP_PROXY` alone does not proxy HTTPS or gRPC traffic. Requests to `localhost` and loopback addresses are not proxied. +### Dedicated proxy -### Dedicated proxy for Sourcegraph managed services - -To route traffic to [Sourcegraph managed services](#outbound-access-to-sourcegraph-managed-services) through a separate proxy, set `SERVICES_GATEWAY_PROXY` to the same value on every `frontend` replica, then restart them: +To route this traffic through a separate proxy, set `SERVICES_GATEWAY_PROXY` to the same value on every `frontend` replica, then restart them: ```sh SERVICES_GATEWAY_PROXY=http://username:password@proxy.example.com:3128 @@ -53,9 +44,20 @@ Do not set it on other services: they receive the value from `frontend` and rest - Only `http://` proxies that support HTTP CONNECT are supported. Basic authentication is optional; URL-encode special characters in credentials. - TLS to the destination is preserved, but the connection to the proxy is not encrypted. -- It takes precedence over `HTTPS_PROXY` and `NO_PROXY`, including for `localhost` endpoint overrides. +- It takes precedence over the [standard proxy variables](#http-proxy-configuration), including `NO_PROXY` and `localhost` endpoint overrides. - If the proxy is unreachable, requests fail instead of connecting directly. +## HTTP proxy configuration + +Sourcegraph services use the conventional `HTTP_PROXY`, `HTTPS_PROXY`, and `NO_PROXY` environment variables. Set them on the `frontend` and `worker` services, using the example override file for your deployment method: + +- [Kubernetes Helm](https://github.com/sourcegraph/deploy-sourcegraph-helm/blob/main/charts/sourcegraph/examples/outbound-http-proxy/override.yaml) +- [Docker Compose](https://github.com/sourcegraph/deploy-sourcegraph-docker/blob/main/docker-compose/examples/outbound-http-proxy/docker-compose.override.yaml) + +`HTTP_PROXY` alone does not proxy HTTPS or gRPC traffic. Requests to `localhost` and loopback addresses are not proxied. + +Traffic to Sourcegraph managed services can use a [dedicated proxy](#dedicated-proxy) instead. + ## Docker networking configuration If there is an IP conflict on between the host network and the Docker network, you may need to configure the docker CIDR From 9c7a1f58eef5873bc170cdffa9de65de3f3aa403 Mon Sep 17 00:00:00 2001 From: Robert Lin Date: Mon, 16 Nov 2026 20:58:18 +0000 Subject: [PATCH 6/9] Clarify proxy precedence Amp-Thread-ID: https://ampcode.com/threads/T-9a5ed1e5-6bb8-4d58-b173-d5a8aa69a93b Co-authored-by: Amp --- docs/self-hosted/private-network.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/self-hosted/private-network.mdx b/docs/self-hosted/private-network.mdx index ec8d3b577..4a3a3817f 100644 --- a/docs/self-hosted/private-network.mdx +++ b/docs/self-hosted/private-network.mdx @@ -44,7 +44,7 @@ Do not set it on other services: they receive the value from `frontend` and rest - Only `http://` proxies that support HTTP CONNECT are supported. Basic authentication is optional; URL-encode special characters in credentials. - TLS to the destination is preserved, but the connection to the proxy is not encrypted. -- It takes precedence over the [standard proxy variables](#http-proxy-configuration), including `NO_PROXY` and `localhost` endpoint overrides. +- It takes precedence over the [standard proxy variables](#http-proxy-configuration), including `NO_PROXY`, and also applies to `localhost` endpoint overrides. - If the proxy is unreachable, requests fail instead of connecting directly. ## HTTP proxy configuration From 99a385d665a20091ea85eb165290bc86af13ff87 Mon Sep 17 00:00:00 2001 From: Robert Lin Date: Mon, 16 Nov 2026 21:05:40 +0000 Subject: [PATCH 7/9] Drop generic proxy behavior note Amp-Thread-ID: https://ampcode.com/threads/T-9a5ed1e5-6bb8-4d58-b173-d5a8aa69a93b Co-authored-by: Amp --- docs/self-hosted/private-network.mdx | 2 -- 1 file changed, 2 deletions(-) diff --git a/docs/self-hosted/private-network.mdx b/docs/self-hosted/private-network.mdx index 4a3a3817f..b9e443e61 100644 --- a/docs/self-hosted/private-network.mdx +++ b/docs/self-hosted/private-network.mdx @@ -54,8 +54,6 @@ Sourcegraph services use the conventional `HTTP_PROXY`, `HTTPS_PROXY`, and `NO_P - [Kubernetes Helm](https://github.com/sourcegraph/deploy-sourcegraph-helm/blob/main/charts/sourcegraph/examples/outbound-http-proxy/override.yaml) - [Docker Compose](https://github.com/sourcegraph/deploy-sourcegraph-docker/blob/main/docker-compose/examples/outbound-http-proxy/docker-compose.override.yaml) -`HTTP_PROXY` alone does not proxy HTTPS or gRPC traffic. Requests to `localhost` and loopback addresses are not proxied. - Traffic to Sourcegraph managed services can use a [dedicated proxy](#dedicated-proxy) instead. ## Docker networking configuration From e652d4912da6357c20b3d57c71da462f12faa01c Mon Sep 17 00:00:00 2001 From: Robert Lin Date: Mon, 16 Nov 2026 21:06:12 +0000 Subject: [PATCH 8/9] Link dedicated proxy to HTTP proxy configuration Amp-Thread-ID: https://ampcode.com/threads/T-9a5ed1e5-6bb8-4d58-b173-d5a8aa69a93b Co-authored-by: Amp --- docs/self-hosted/private-network.mdx | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/self-hosted/private-network.mdx b/docs/self-hosted/private-network.mdx index b9e443e61..9e03d7219 100644 --- a/docs/self-hosted/private-network.mdx +++ b/docs/self-hosted/private-network.mdx @@ -44,9 +44,11 @@ Do not set it on other services: they receive the value from `frontend` and rest - Only `http://` proxies that support HTTP CONNECT are supported. Basic authentication is optional; URL-encode special characters in credentials. - TLS to the destination is preserved, but the connection to the proxy is not encrypted. -- It takes precedence over the [standard proxy variables](#http-proxy-configuration), including `NO_PROXY`, and also applies to `localhost` endpoint overrides. +- It takes precedence over `HTTPS_PROXY` and `NO_PROXY`, and also applies to `localhost` endpoint overrides. - If the proxy is unreachable, requests fail instead of connecting directly. +To proxy other outbound traffic, see [HTTP proxy configuration](#http-proxy-configuration). + ## HTTP proxy configuration Sourcegraph services use the conventional `HTTP_PROXY`, `HTTPS_PROXY`, and `NO_PROXY` environment variables. Set them on the `frontend` and `worker` services, using the example override file for your deployment method: From 893fd852cacd476d3ad5463f8a8dd7fd35b8ab97 Mon Sep 17 00:00:00 2001 From: Robert Lin Date: Mon, 16 Nov 2026 21:13:19 +0000 Subject: [PATCH 9/9] Revert to Sourcegraph services naming Amp-Thread-ID: https://ampcode.com/threads/T-9a5ed1e5-6bb8-4d58-b173-d5a8aa69a93b Co-authored-by: Amp --- docs/admin/architecture.mdx | 2 +- docs/admin/enterprise-portal.mdx | 2 +- docs/admin/pings.mdx | 2 +- docs/admin/telemetry/index.mdx | 2 +- docs/self-hosted/private-network.mdx | 6 ++---- 5 files changed, 6 insertions(+), 8 deletions(-) diff --git a/docs/admin/architecture.mdx b/docs/admin/architecture.mdx index 4bd99bbcb..1f9cd017a 100644 --- a/docs/admin/architecture.mdx +++ b/docs/admin/architecture.mdx @@ -298,7 +298,7 @@ flowchart LR click ModelProvider "#model-provider" ``` -For the services gateway's IP address, required ports and protocols, and firewall and proxy configuration, see [outbound access to Sourcegraph managed services](/self-hosted/private-network#outbound-access-to-sourcegraph-managed-services). Other enabled features and integrations may require additional external destinations. +For the services gateway's IP address, required ports and protocols, and firewall and proxy configuration, see [outbound access to Sourcegraph services](/self-hosted/private-network#outbound-access-to-sourcegraph-services). Other enabled features and integrations may require additional external destinations. ### Model Provider diff --git a/docs/admin/enterprise-portal.mdx b/docs/admin/enterprise-portal.mdx index c0c9237f8..30f05dc69 100644 --- a/docs/admin/enterprise-portal.mdx +++ b/docs/admin/enterprise-portal.mdx @@ -37,7 +37,7 @@ Subscription admins can view [Sourcegraph Analytics](/analytics) for the subscri Subscription admins can view credit balances and rates for metered services, including [Deep Search](/deep-search) and [Agentic Batch Changes](/agentic-batch-changes), on the **Credits** page. This replaces the former Deep Search usage monitoring page and shows subscription-wide consumption, not an individual user's usage. -Self-hosted instances need outbound connectivity to Enterprise Portal through the services gateway for credit/quota checks and consumption reporting. Before using metered services, configure the [required outbound access](/self-hosted/private-network#outbound-access-to-sourcegraph-managed-services), including IP allowlisting if your network restricts egress. +Self-hosted instances need outbound connectivity to Enterprise Portal through the services gateway for credit/quota checks and consumption reporting. Before using metered services, configure the [required outbound access](/self-hosted/private-network#outbound-access-to-sourcegraph-services), including IP allowlisting if your network restricts egress. 1. [Sign in to Enterprise Portal](#accessing-sourcegraph-enterprise-portal) as a subscription admin. 2. Select your subscription. diff --git a/docs/admin/pings.mdx b/docs/admin/pings.mdx index 23569164c..04c3ded56 100644 --- a/docs/admin/pings.mdx +++ b/docs/admin/pings.mdx @@ -202,7 +202,7 @@ Sourcegraph aggregates usage and performance metrics for some product features i ## Allowlist IPs / CIDR Ranges for Sourcegraph -Refer to [outbound access to Sourcegraph managed services](/self-hosted/private-network#outbound-access-to-sourcegraph-managed-services) for the destinations, ports, and protocols to allow. +Refer to [outbound access to Sourcegraph services](/self-hosted/private-network#outbound-access-to-sourcegraph-services) for the destinations, ports, and protocols to allow. ## Using an HTTP proxy for ping requests diff --git a/docs/admin/telemetry/index.mdx b/docs/admin/telemetry/index.mdx index 76971e089..91453fbaa 100644 --- a/docs/admin/telemetry/index.mdx +++ b/docs/admin/telemetry/index.mdx @@ -47,7 +47,7 @@ You can reach out to support@sourcegraph.com for additional information about ho ## Allowlist IPs / CIDR ranges for Sourcegraph -See [outbound access to Sourcegraph managed services](/self-hosted/private-network#outbound-access-to-sourcegraph-managed-services) for the services gateway's IP, hostname, and protocol requirements. +See [outbound access to Sourcegraph services](/self-hosted/private-network#outbound-access-to-sourcegraph-services) for the services gateway's IP, hostname, and protocol requirements. ## Architecture diff --git a/docs/self-hosted/private-network.mdx b/docs/self-hosted/private-network.mdx index 9e03d7219..2d12bfab8 100644 --- a/docs/self-hosted/private-network.mdx +++ b/docs/self-hosted/private-network.mdx @@ -24,9 +24,7 @@ The following [Sourcegraph services](/admin/architecture) initiate outbound conn - **worker**: Sourcegraph Worker background jobs that may require establishing connections to services hosted within an organization's private network - - -## Outbound access to Sourcegraph managed services +## Outbound access to Sourcegraph services Sourcegraph makes requests to `https://services.sourcegraph.com` for [key product capabilities](/admin/architecture#connections-to-sourcegraph-managed-services). @@ -56,7 +54,7 @@ Sourcegraph services use the conventional `HTTP_PROXY`, `HTTPS_PROXY`, and `NO_P - [Kubernetes Helm](https://github.com/sourcegraph/deploy-sourcegraph-helm/blob/main/charts/sourcegraph/examples/outbound-http-proxy/override.yaml) - [Docker Compose](https://github.com/sourcegraph/deploy-sourcegraph-docker/blob/main/docker-compose/examples/outbound-http-proxy/docker-compose.override.yaml) -Traffic to Sourcegraph managed services can use a [dedicated proxy](#dedicated-proxy) instead. +Traffic to Sourcegraph services can use a [dedicated proxy](#dedicated-proxy) instead. ## Docker networking configuration