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.
Shipped
Click a lifecycle step above to view its details.
Sign in to post a ripple.