Outbound connections
This page lists the hosts that Orchard contacts on its own, and how to turn each one off. If you restrict outbound traffic, use it as your allowlist.
It does not list connections to services you configure yourself, such as S3 storage, SMTP, notification webhooks, identity providers, and Git providers. Builds also download whatever your Dockerfile or package manager asks for.
The installer
Section titled “The installer”| Host | Used for |
|---|---|
assets.orchard.my |
The install script. |
api.ipify.org, ipv4.icanhazip.com |
Finding the machine’s public IPv4 address. The second is tried if the first fails. |
api6.ipify.org |
Finding the machine’s public IPv6 address. |
1.1.1.1, 8.8.8.8, 2606:4700:4700::1111, over DNS |
Checking your DNS records. Set ORCHARD_DNS_RESOLVERS to use other resolvers. |
cloudflare-dns.com, dns.google, over HTTPS |
Checking your DNS records, when dig is missing or those resolvers do not answer. |
get.k3s.io, update.k3s.io, github.com |
The k3s install script, its release channels, and its binary. |
raw.githubusercontent.com, get.helm.sh |
The Helm install script and binary. |
github.com |
yq. |
traefik.github.io, cloudnative-pg.github.io, charts.jetstack.io |
The Traefik, CloudNativePG, and cert-manager charts. |
ghcr.io |
The Orchard chart and images, and the CloudNativePG images. |
Docker Hub, quay.io, registry.k8s.io |
Other images that k3s, the operators, and the chart run. |
acme-v02.api.letsencrypt.org |
Certificates, in public mode. |
| Cloudflare’s network | The tunnel connection, in tunnel mode. |
Host commands
Section titled “Host commands”| Host | Used by | To turn it off |
|---|---|---|
update.k3s.io, github.com |
orchardctl k3s and orchardctl update |
Set ORCHARD_K3S_UPDATES=off in /etc/orchard/env. |
traefik.github.io, cloudnative-pg.github.io, charts.jetstack.io |
orchardctl update |
Set ORCHARD_ADDON_UPDATES=off in /etc/orchard/env. |
ghcr.io, Docker Hub, quay.io, registry.k8s.io |
orchardctl update and orchardctl images |
Set ORCHARD_ADDON_UPDATES=off in /etc/orchard/env. |
api.osv.dev |
orchardctl update and orchardctl images, for security advisories about the running third-party versions |
Set ORCHARD_ADDON_UPDATES=off in /etc/orchard/env. |
hub.docker.com |
orchardctl update and orchardctl images, for the date that a Docker Hub tag was pushed |
Set ORCHARD_ADDON_UPDATES=off in /etc/orchard/env. |
api.github.com |
orchardctl images, for the latest Railpack |
Do not run the command. |
assets.orchard.my/registry |
orchardctl graft, for the Extension Marketplace |
Set ORCHARD_GRAFT_MARKETPLACE_URL to your own registry. |
A running instance
Section titled “A running instance”| Host | When | To turn it off |
|---|---|---|
us.i.posthog.com |
Only after a superadmin opts in to usage reports. | Leave reports off, or set ORCHARD_TELEMETRY=false. |
assets.orchard.my/registry |
Every 6 hours, for templates. | Set TEMPLATE_REGISTRY_URL to an empty value, or to your own registry. |
assets.orchard.my/updates/ui |
For the release notes that the dashboard shows after a dashboard release. | Set UPDATES_URL=off, or run sudo orchardctl config set updates.url off --apply. |
assets.orchard.my |
When the dashboard loads a template or graft icon through its image proxy. | Set ASSET_PROXY_HOSTS on the frontend to your own host. |
raw.githubusercontent.com |
To read the CloudNativePG image catalog, which lists the Postgres versions on offer. | Set POSTGRES_IMAGE_CATALOG_URL to your own copy. |
www.postgresql.org |
Every hour, to read Postgres versions and security advisories. | No setting. |
ipwho.is |
Only with SIGN_IN_LOCATION_LOOKUP=true. When someone signs in from a public address, Orchard sends that address and shows the approximate location in the session list and sign-in alerts. |
Off by default. Leave SIGN_IN_LOCATION_LOOKUP unset. |
seccdn.libravatar.org, gravatar.com |
To import a profile picture, at most once per user every 30 days. Orchard sends a hash of the email address. | Set EMAIL_AVATAR_LOOKUP=false. |
data.iana.org, and the RDAP server for a domain |
To check when a domain was registered, for organization domains and email sign-in codes. | No setting. |
acme-v02.api.letsencrypt.org |
For certificates, through cert-manager. | Use your own issuer. |
update.traefik.io |
Traefik’s own check for a new version. | Set global.checkNewVersion to false in the Traefik chart values. |
github.com, api.github.com |
For the GitHub App, and to clone repositories. | Do not connect GitHub. Public repositories are cloned when someone deploys one. |
github.com |
When a build uses Railpack, to download it. | Deploy with a Dockerfile or an image. |
mirror.gcr.io, ghcr.io |
For the image scanner’s vulnerability database. | Set trivy.dbRepository and trivy.javaDbRepository, or set trivy.enabled to false. |
api.cloudflare.com |
When you manage Cloudflare Tunnel routes from Instance admin > Networking. | Do not connect Cloudflare. |
challenges.cloudflare.com |
When bot protection is on. | Turn off bot protection. |
depot.dev |
When a build uses Orchard’s super builds. | Do not turn on super builds. |
Your own analytics
Section titled “Your own analytics”Orchard can send product analytics to a PostHog project that you own. Both settings are empty in the chart, the installer, and the published images, so nothing is sent until you set a key.
| Setting | Where | What it sends |
|---|---|---|
POSTHOG_API_KEY, POSTHOG_HOST |
Server | Server-side analytics to POSTHOG_HOST, which defaults to us.i.posthog.com. |
PUBLIC_POSTHOG_KEY, PUBLIC_POSTHOG_HOST |
Frontend runtime | The dashboard loads PostHog in each person’s browser and sends page views, web vitals, network timing, and errors to PUBLIC_POSTHOG_HOST, which defaults to us.i.posthog.com. If your PostHog project records sessions, the dashboard sends session recordings too. Orchard removes request and response bodies and secrets in URLs before it sends network data. The frontend server also reports its own errors there. |
These are separate from anonymous usage reports, which go to the Orchard team only after a superadmin opts in. To set a frontend variable with the chart, use frontend.env.
Installed grafts can make connections of their own.
Related resources
Section titled “Related resources”- Manage anonymous usage reports - Review what usage reports contain and how to turn them off.
- Environment variables - Look up every server variable named on this page.