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

Relationships

↔ sibling #4620↔ sibling #4582↔ sibling #4572↔ sibling #4571↔ sibling #4570↔ sibling #4636

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

Opened by stack72 · 11/11/2026· Shipped 11/12/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+ 6 MOREISSUE_LINKED+ 8 MOREREVIEW+ 7 MOREISSUE_LINKED+ 2 MORESESSION_SUMMARIZED

Shipped

11/12/2026, 10:12:24 PM

Click a lifecycle step above to view its details.

03Sludge Pulse
stack72 assigned stack7211/12/2026, 6:10:48 PM
stack72 linked sibling of #462011/12/2026, 6:11:25 PM
stack72 linked sibling of #458211/12/2026, 6:11:28 PM
stack72 linked sibling of #457211/12/2026, 6:11:30 PM
stack72 linked sibling of #457111/12/2026, 6:11:33 PM
stack72 linked sibling of #457011/12/2026, 6:11:36 PM
stack72 linked sibling of #463611/12/2026, 9:52:31 PM

Sign in to post a ripple.