Skip to content
Install

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.

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 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.
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.

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.