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

Relationships

↔ sibling #4577

#4829 Docs: how to rotate swamp serve's TLS certificate (rolling restart on Linux, or TLS at a proxy)

Opened by stack72 · 11/17/2026· Shipped 11/19/2026

#4810 (rotate serve's TLS certificate on reload) was closed as not feasible on Deno today; see its closing ripple for the evidence. The manual should say how to rotate serve's own certificate, so operators don't look for a reload that won't come.

Page

content/manual/reference/swamp-serve/ (the page that covers --cert-file / --key-file / tls), or the TLS how-to content/manual/how-to/set-up-tls-for-swamp-serve.md.

Content

Rotating the certificate. swamp serve reload does not re-read tls.cert-file, tls.key-file or tls.ca-cert; it reports them as needing a restart. To rotate:

  • Linux: do a rolling restart with --reuse-port. Start the new serve, wait for its /ready, then stop the old one. No request fails, and in-flight runs are parked at a step boundary and continued by the new process.
  • Frequent rotation (ACME, short-lived internal certificates): terminate TLS at a proxy or load balancer in front of serve, run serve on plain HTTP behind it, and set trust-proxy. The proxy rotates certificates without serve noticing.
  • macOS and Windows: restart serve. Connections are refused briefly while it restarts; in-flight runs still survive the restart.

Include a short systemd example of the rolling restart, and remind readers that a renewed certificate on disk is not in use until serve restarts.

02Bog Flow
✓OPEN✓TRIAGED✓IN PROGRESS✓SHIPPEDLINKED+ 3 MOREPR_LINKED+ 1 MORESESSION_SUMMARIZED

Shipped

11/19/2026, 6:06:02 PM

Click a lifecycle step above to view its details.

03Sludge Pulse
stack72 linked sibling of #457711/19/2026, 5:05:32 PM

Sign in to post a ripple.