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

Relationships

↔ sibling #3695

#3599 Docs: worker daemon enable reference is missing --ca-cert, --concurrency and SWAMP_SERVE_EXTRA_HEADERS

Opened by stack72 · 10/19/2026· Shipped 10/22/2026

swamp-club#3575 brings worker daemon enable to parity with worker connect. The manual page content/manual/reference/remote-execution/worker-commands.md (section: swamp worker daemon enable) needs:

  • Flags table: add --ca-cert (PEM CA certificate to trust for the orchestrator; made absolute and must exist; a system service must be able to read it; written as SWAMP_CA_CERT) and --concurrency <n|auto> (dispatch slots; auto resolves to the CPU count of the machine running the service; written as SWAMP_WORKER_CONCURRENCY).
  • Note that relative --token-file, --server-token-file, --cache-dir and --ca-cert paths are made absolute at enable time.
  • Note that SWAMP_SERVE_EXTRA_HEADERS set in the shell running daemon enable is carried into the service (header names are printed, values are not).
  • Note that enable now refuses values worker connect would refuse at start (non ws/wss URL, --max-dispatches below 1, invalid --idle-timeout, --concurrency, labels containing a comma that does not start another key=value, invalid headers).
  • The usage line should list the new flags.
  • Labels: when a --label value contains a comma (or spaces the service trims), daemon enable still installs but warns that the service reads it as different labels, e.g. --label a=x,y=z reaches the service as a=x and y=z (labels go to the service comma-separated). A label the service cannot read back at all (e.g. a=b,c) is refused, naming the offending --label.
  • The daemon enable description says SWAMP_SERVE_EXTRA_HEADERS from the enabling shell is written into the service.

Implemented in swamp-club/swamp#3191.

02Bog Flow
✓OPEN✓TRIAGED✓IN PROGRESS✓SHIPPED+ 1 MOREASSIGNED+ 6 MOREREVIEW+ 6 MOREPR_LINKED+ 1 MORENOTIFICATION_SKIPPED

Shipped

10/22/2026, 3:13:06 PM

Click a lifecycle step above to view its details.

03Sludge Pulse
stack72 assigned stack7210/22/2026, 1:32:35 PM
stack72 linked sibling of #369510/22/2026, 1:33:09 PM
Editable. Press Enter to edit.

stack72 commented 10/19/2026, 4:14:52 PM

Two more points for the worker daemon enable reference, from swamp-club#3604:

  • sudo drops SWAMP_SERVE_EXTRA_HEADERS by default (env_reset). A system service enabled with sudo needs sudo -E or sudo --preserve-env=SWAMP_SERVE_EXTRA_HEADERS, or the service is written without the headers. The enable help now says this, and its reverse-proxy example uses the preserve-env form.
  • --ca-cert must be readable by the user running enable. An unreadable file (for example mode 000) is now refused with: --ca-cert file not readable: .

Sign in to post a ripple.