Skip to main content

Network egress

This page lists every destination that the Helm deployment and its host connect to. Use it to build a firewall allowlist. Network policy lists the connections inside the cluster.

Sandboxes have no internet access. Review and conversation sandboxes reach only the sandbox gateway of the server. The threat model gives the controls that limit the destinations below.

Host​

The host connects to these destinations during installation, upgrades, and each run of pull-based deployment.

DestinationPurpose
ghcr.io and docker.ioPull the release images by digest. Registry authentication and download redirects use more hosts of these registries, so an allowlist of the two names alone is not sufficient.
github.com, api.github.com, and the GitHub release-asset download hostsDownload the signed release lock and its assets.
fulcio.sigstore.dev, rekor.sigstore.dev, and tuf-repo-cdn.sigstore.devVerify the keyless signatures of the release lock.
registry.k8s.io and the hosts that it redirects toPull the agent-sandbox controller image by digest, on a cluster that runs practice reviews.

One host on k3s​

A one-host install on k3s also needs these destinations:

DestinationPurpose
github.com, raw.githubusercontent.com, and the GitHub release-asset download hostsDownload the k3s installer, k3s, and the release assets.
charts.jetstack.ioDownload the cert-manager chart.
storage.googleapis.comDownload the pinned gVisor release, which runs the sandboxes.
traefik.github.ioDownload the Traefik chart.
quay.ioPull the cert-manager images by digest.
docker.ioPull the Traefik image by digest, and the images that k3s ships.
The Let's Encrypt ACME APIIssue and renew the Gateway certificate through cert-manager.

A model endpoint that this host's own Gateway serves needs networkPolicy.modelGatewayPorts, as Reach a model endpoint on the cluster's own ingress describes.

Containers​

DestinationPurposeContainerWhen
The Let's Encrypt ACME APIIssue and renew the TLS certificate.cert-managerWhen cert-manager issues or renews an ACME certificate.
The API of your DNS providerAnswer the DNS-01 challenge.cert-managerWhen the selected ClusterIssuer uses DNS-01.
github.com and api.github.comSign-in, repository sync, feedback delivery, and Git fetches.application-serverWhen GitHub sign-in or a GitHub workspace is configured.
The GitLab instance (config.gitlab.oauthBaseUrl)Sign-in, sync, group hook registration, feedback delivery, and Git fetches.application-serverWhen GitLab is configured. A private address also needs config.scmPrivateHosts (Connect to services on a private network).
slack.com, the Slack API baseSlack API calls and Slack account linking.application-serverWhen config.slack.enabled is true.
The Outline origins in config.outline.allowedOriginsDocument sync and Outline account linking.application-serverWhen config.outline.enabled is true.
The base URL of each AI provider connectionModel calls of practice reviews and conversations, through the LLM proxy of the server. The server also tests a connection when an admin selects Test and fetch models.application-serverWhen an admin registers a provider connection (Connect an AI provider). A private address also needs config.llmPrivateHosts (Connect to services on a private network).
api.github.comThe update check.application-serverBy default, on a release. A commit channel or a local build is never checked. config.releaseCheckEnabled: false turns it off.
www.ecb.europa.euDaily currency rates for the second display currency.application-serverOnly when config.llmDisplayCurrency is set.
Your SMTP relay (config.email.host)Email.application-serverOnly when config.email.host is set.
Your OTLP endpoint (config.tracing.otlpEndpoint)Traces.application-serverOnly when config.tracing.otlpEnabled is true (Set up monitoring).
Your log store's OTLP endpointLogs.The optional log collector on each nodeOnly when you run it (Collecting logs).
The pgBackRest repository: your S3 endpoint (postgresql.backup.s3.endpoint)Off-host backups, WAL archiving, and restore.PostgreSQL and the backup and restore Jobs of the chartWhen chart backup or restore is enabled (Backup & restore).