remote-for-xirp/docs/proxy.md at main · AboveColin/remote-for-xirp · GitHub
Skip to content

Latest commit

 

History

History
16 lines (14 loc) · 893 Bytes

proxy.md

File metadata and controls

16 lines (14 loc) · 893 Bytes

Putting it behind a reverse proxy

Optional, and worth it for TLS and a memorable hostname. Three notes from running it this way:

  • Give it its own config file rather than appending to a shared routes file. Appending can silently land a router definition inside a services block, where it is ignored and the URL just 404s.
  • If the machine is a laptop, define two backends and health-check them. A laptop has one address on its home network and a different one over a VPN, and typically only one of the two is reachable at a time. A single backend URL is therefore wrong half the time; with a health check on /healthz the proxy follows the laptop between locations with no edit. An example is in deploy/traefik-xirp-remote.yml.
  • /healthz is unauthenticated on purpose, so an uptime monitor works even when a key is set.