Skip to content

docs: Document services gateway outbound allowlisting and credits connectivity - #2090

Open
bobheadxi wants to merge 9 commits into
mainfrom
robert/services-gateway-allowlisting
Open

bobheadxi wants to merge 9 commits into
mainfrom
robert/services-gateway-allowlisting

Conversation

@bobheadxi

@bobheadxi bobheadxi commented Oct 13, 2026 •

Copy link
Copy Markdown
Member

Document services.sourcegraph.com outbound access on 34.36.231.254:443 (HTTPS and HTTP/2 gRPC), linked from telemetry, Pings, and Credits. Add timeless documentation guidance to AGENTS.md.

Merge after 8.1 releases. Related: client, upgrade notes, legacy RPC removal, and infrastructure gateway, retained IP, DNS.

Checks: build, links/anchors, filenames, images, spelling, hostnames, and rendered-page inspection.

Keep older and custom endpoints and link credits connectivity to canonical network requirements for upcoming 8.1.

Amp-Thread-ID: https://ampcode.com/threads/T-26fae6b7-6e69-4053-9d3d-7b5c04f2cebc
Co-authored-by: Amp <amp@ampcode.com>
@vercel

vercel Bot commented Oct 13, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
sourcegraph-docs Ready Ready Preview Oct 13, 2026 6:55pm UTC

Request Review

@github-actions

github-actions Bot commented Oct 13, 2026 •

Copy link
Copy Markdown
Contributor

Direct preview links to pages changed in this PR:

@github-actions

Copy link
Copy Markdown
Contributor

@github-actions

This comment has been minimized.

@bobheadxi
bobheadxi marked this pull request as ready for review October 13, 2026 04:08
@bobheadxi
bobheadxi requested review from a team, eseliger and marcleblanc2 October 13, 2026 04:08
Comment thread docs/admin/telemetry/index.mdx Outdated
Comment thread docs/admin/enterprise-portal.mdx Outdated
Comment thread docs/admin/pings.mdx Outdated
Comment thread docs/admin/pings.mdx Outdated
Comment thread docs/self-hosted/private-network.mdx Outdated
@bobheadxi
bobheadxi marked this pull request as draft October 13, 2026 18:20
Keep publication gated on 8.1, describe current behavior concisely, and record documentation conventions.

Amp-Thread-ID: https://ampcode.com/threads/T-26fae6b7-6e69-4053-9d3d-7b5c04f2cebc
Co-authored-by: Amp <amp@ampcode.com>
Comment thread docs/self-hosted/private-network.mdx Outdated
- `sourcegraph.com`: the full [Cloudflare IP ranges](https://www.cloudflare.com/ips/), when required by your configured services.

Keep access to your configured Enterprise Portal endpoint and any other custom endpoints. Do not remove those rules merely because the services gateway is available.
The gateway is not Cloudflare-proxied and does **not** require Cloudflare's shared IP ranges. This IP covers only these service interactions. Keep separate access rules for code hosts, LLM providers, update/download artifacts, browser access to Enterprise Portal, custom endpoints, and other enabled integrations.

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.

@bobheadxi the absence of Cloudflare is not required to mention here, this could be said in fewer words.

I'm curious about a better way to frame this. Telemetry / pings / events / license validity checks / upgrade checks, all sound like "telemetry" to me, wearing my customer hat. services.sourcegraph.com is generic / vague, which creates the need for clarity around this endpoint vs our LLM gateway endpoint. I'm not sure if the LLM gateway should also be served on the same URL / IP / port for easier egress allowlisting, or what level of clarity we need in the docs.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

hmm yeah this is a bit slop. FWIW, a lot of stuff covered now is not telemetry (credit consumption and credit quota checks, site admin notifications broadcast by us)

@bobheadxi bobheadxi Oct 13, 2026 •

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

WDYT about:

Sourcegraph makes requests to https://services.sourcegraph.com for key product capabilities.

To ensure a smooth experience, instances must allow [...]

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.

👍

credit consumption and credit quota checks, site admin notifications

I’m fairly liberal with my definition of telemetry, and these bits fit into the same conversation with the customer admin and their NetSec team.

key product capabilities

I’ll put some thought into this. We can ship your proposed fix and iterate to clarify if needed.

Keep the previous Pings section anchor with a link to the new location.

Amp-Thread-ID: https://ampcode.com/threads/T-26fae6b7-6e69-4053-9d3d-7b5c04f2cebc
Co-authored-by: Amp <amp@ampcode.com>

This branch was successfully deployed

1 active deployment
Preview — fe4b5ce4 Deployed Oct 13, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants