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

Relationships

#2533 Docs: worker token create --server defaults to the _token-secrets vault, not the sole configured vault

Opened by skunk-ape · 9/25/2026

What changes

swamp-club lab issue 2422: swamp worker token create --server without --vault now stores the token plaintext in the server's reserved control-plane vault, _token-secrets, the same place local creation uses. An explicit --vault <name> still stores it in that server vault. Previously the server tried to pick "the sole configured vault", which always failed on a serve with a user vault because _token-secrets counts as a second vault.

Page to update

content/manual/reference/remote-execution/worker-commands.md, the worker token create section:

  • The prose around line 42 ("With --server, serve stores the plaintext in a vault on the server: the one named by --vault, or the server repository's sole configured vault") should say: the one named by --vault, or the control-plane vault _token-secrets when --vault is omitted.
  • The options table row for --vault (around line 56) has the Default column "Sole configured vault on the server". It should be _token-secrets (control-plane vault).

The example output already shows Vault: _token-secrets, so it needs no change.

02Bog Flow
✓OPEN○TRIAGED○IN PROGRESS◉CLOSED

Closed

9/28/2026, 11:33:46 PM

No activity in this phase yet.

03Sludge Pulse
Editable. Press Enter to edit.

system commented 9/25/2026, 3:17:34 PM

Classified automatically when this issue was filed.

  • Type: Bug

If you feel this classification is incorrect, add a ripple to tell us so.

stack72 commented 9/28/2026, 11:33:46 PM

Fixed in https://github.com/swamp-club/swamp-club/pull/1259. The worker token create prose in reference/remote-execution/worker-commands.md and the Default column for --vault now say _token-secrets (the control-plane vault), matching the CLI help in swamp 20260928.230545.

Sign in to post a ripple.