Networking
Everything on this tab is written onto the container as Traefik labels at create time, so saving a change here doesn't affect the container that's already running. Once a service has been deployed, the tab shows a Redeploy button for exactly that reason, use it after changing a domain or DNS-resolvability. The per-app login wall lives on the Security tab.
- Container port, protocol, network mode,
bridge(default, joins the sharedhomerunplus the service's stack network if any) orhost(shares the host's network namespace directly, for apps needing real host-network access like mDNS/SSDP discovery). Homerun never publishes/maps a host port either way; a bridge-mode service is reachable only via its Traefik subdomain, a host-mode service only directly on the host's own port. - DNS-resolvable, whether Traefik gets discovery labels at all. Forced off automatically in host mode (there's no per-container IP for Traefik's Docker provider to route to).
- Domains, a list of extra hostnames on top of the automatic
<slug>.<baseDomain>one (which has its own "Routed" toggle, so it can be dropped once a real domain replaces it), each routed to the same backend. Pick one as the main domain: it's the link shown under the service's name and the one used for deploy notifications, the uptime probe and search. At least one hostname has to stay routed, otherwise turn public routing off in the Network section below instead.
Domains & SSL
A domain that isn't under your instance's own base domain can't use Traefik's
automatic ACME resolver (and none of them can while the instance sits behind
Pangolin, which serves certificates itself), so for those domains the Networking
tab's SSL section lets you paste your own cert/key PEM (encrypted at rest, same
scheme as registry credentials). It works out of the box: compose.prod.yaml
and the installer's stack share a traefik-dynamic volume between Homerun and
Traefik, turn on Traefik's file provider over it, and set
TRAEFIK_DYNAMIC_CONFIG_DIR (see Configuration) so Homerun
knows where to write. Saving a cert writes the cert, key and a dynamic-config
file into that directory, and Traefik's file provider picks them up on its own
(no restart per certificate). An instance started from an older compose file
without that volume and those flags has to add them once; until then, saving a
cert does nothing.
This guide lives in the project repo: edit it there, and this page follows within a day.