Yard Docs
Sign in

Behind nginx

Run Yard hosting behind nginx that holds ports 80 and 443.

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.

Steps

  1. In the runner's Hosting settings choose TLS: Behind another proxy. The runner listens on 127.0.0.1:8443.
  2. Open the nginx tab of the generated config and copy it into a file in nginx's conf.d (or sites-enabled). It proxies *.apps.example.com and apps.example.com to the listen address and passes Host on.
  3. Get a wildcard certificate with DNS-01 (certbot with your DNS provider's plugin) and point ssl_certificate at it.
  4. nginx -t && nginx -s reload, then Test route.

nginx on the host reaches 127.0.0.1:8443 directly, so no other address is needed. If nginx runs in a container, the doctor names the network gateway to use instead.

Was this page useful?
Edit this page