Yard Docs
Sign in
On this page

Behind a proxy, by hand

Run Yard hosting behind a proxy on a machine where the runner is started by hand or by systemd, without Docker.

Updated October 15, 2026 ยท 1 min read

Read Hosting behind another proxy first for the concepts. When something fails, run yard hosting doctor: it is read-only and names what to change.

When this applies

The runner runs directly on the host (by hand or under systemd) and the other proxy runs on the host too. There is no Docker or compose in this picture.

Steps

  1. Set the listen address to 127.0.0.1:8443 and TLS to Behind another proxy (Hosting settings, or yard runner hosting set --listen 127.0.0.1:8443).
  2. Copy the config for your proxy from the Hosting settings into the proxy's configuration and reload it.
  3. Give the proxy a DNS-01 wildcard certificate.
  4. Run yard hosting doctor. With no Docker the checks that need it are listed as skipped, with the reason; the rest still run.

The proxy and the runner are on the same host, so loopback is enough and the doctor proposes no change.

Was this page useful?
Edit this page