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

Relationships

#4635 Docs: hot-reload manual page lists which serve settings reload, including grant settings and admin removal

Opened by stack72 · 11/11/2026

swamp-club#4588, #4602 and #4604 made most of serve.yaml apply on swamp serve reload. The manual page content/manual/reference/swamp-serve/hot-reload.md describes reloading extensions and grants but does not list which settings a reload applies and which need a restart.

Suggested content:

  • A table of serve.yaml settings: applied on reload, needs a restart (listener, TLS, auth mode, OAuth client, datastore, heartbeat-interval, stale-ttl, remote-only, adding an admin), startup-only.
  • Grant settings (#4604): grant-reload, grants-file, grants-dir and the three explicit-grant rules apply on reload; a grant source startup would refuse refuses the whole reload.
  • Admins: removing an admin applies on reload (on the node leading grant writes in team mode; a follower applies it when it takes the lead); adding one needs a restart.
  • How to read the reload report: applied, needs restart (with reason), overridden by a flag or environment variable.
02Bog Flow
◉OPEN○TRIAGED○IN PROGRESS○SHIPPED

Open

11/11/2026, 9:53:13 AM

No activity in this phase yet.

03Sludge Pulse

Sign in to post a ripple.