Skip to main content
← Back to list
01Issue
FeatureShippedSwamp ClubPublic
AssigneesNone

Relationships

↔ sibling #4556

#4515 Docs: swamp dashboard --port, --trusted-hosts and its new lifetime (swamp-club#4513, #4509)

Opened by stack72 · 11/8/2026· Shipped 11/10/2026

swamp-club#4513 and swamp-club#4509 change swamp dashboard. The manual page content/manual/reference/swamp-serve/dashboard.md, section "swamp dashboard", needs updating once it ships.

What changed

  • The usage line gains two flags: swamp dashboard [--repo-dir <dir>] [--no-browser] [--port <port>] [--trusted-hosts <hosts>].
  • --port <port>: the dashboard listens on 127.0.0.1 on that port instead of any free port, so a reverse proxy has a fixed upstream. A port in use is an error naming it.
  • --trusted-hosts <hosts>: comma-separated host names or host:port, the same shape as swamp serve --trusted-hosts. Requests whose Host is one of them are served instead of answered with 421; the page token is still required on every request. It is for a reverse proxy on the same machine (tailscale serve, caddy) that forwards the browser's Host. nginx sends its upstream address by default and needs only --port. The startup output adds a "Through your proxy, open:" link for each name, which assumes the proxy serves HTTPS; through a plain-http proxy the token crosses the network unencrypted.
  • The line "The server listens only on 127.0.0.1." stays true: there is no option to bind another address.
  • Lifetime: swamp dashboard now keeps running when the terminal or session that started it closes (it ignores SIGHUP), and no longer stops itself ten minutes after the last tab closes. Ctrl-C or SIGTERM stops it. It can be backgrounded with a plain &, no setsid or nohup needed.

Suggested additions

  • The two flags in the usage block and option list.
  • A short example behind a proxy: swamp dashboard --no-browser --port 8765 --trusted-hosts my-machine.tailnet-name.ts.net with tailscale serve --bg 8765.
  • A sentence on how to stop a backgrounded dashboard (Ctrl-C in its terminal, or SIGTERM).
  • The example output and the sentence before it (around "terminal keeps the page running until Ctrl-C" and the sample line "This terminal keeps the page running. Press Ctrl-C to stop it.") are now stale for swamp dashboard: its last line reads "Press Ctrl-C to stop it. Closing this terminal leaves it running." With --trusted-hosts, a "Through your proxy (it must serve HTTPS), open:" heading and one URL per name print just before it.
02Bog Flow
✓OPEN✓TRIAGED✓IN PROGRESS✓SHIPPEDLINKED+ 3 MOREPR_LINKED+ 1 MORESESSION_SUMMARIZED

Shipped

11/10/2026, 7:10:30 AM

Click a lifecycle step above to view its details.

03Sludge Pulse
stack72 linked sibling of #455611/9/2026, 11:33:54 PM

Sign in to post a ripple.