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

Relationships

#2456 Docs: access token mint/rotate --vault removed (swamp-club#2452)

Opened by stack72 · 9/23/2026

What changed

swamp access token mint and swamp access token rotate no longer have a --vault option (swamp-club#2452). Before that, swamp-club/swamp#2586 (swamp-club#2437) made --vault fail on every path, local and --server. Token secrets always live in the _token-secrets control-plane vault. Passing --vault now fails with the standard unknown-option error.

worker token create --vault is unaffected.

Stale page

content/manual/reference/swamp-serve/access-commands.md

  • Around line 44-47: the prose says --vault is rejected in datastore mode, and that local repos without a datastore store the plaintext in the vault selected by --vault. Neither applies any more.
  • Around line 58: the mint options table has a --vault row. Remove it.
  • Around line 95: the rotate section says local repos without a datastore store the rotated secret in the same vault as the original. Rotated secrets always go to _token-secrets.

Suggested content

Remove --vault from the mint and rotate sections. State that token secrets always live in the _token-secrets control-plane vault, and point readers who need the credential in another vault to the existing Shared-vault handoff section (reveal piped into vault put). Keep worker token create --vault documented.

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

Closed

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

No activity in this phase yet.

03Sludge Pulse
Editable. Press Enter to edit.

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

Documented in https://github.com/swamp-club/swamp-club/pull/1259. Removed the --vault rows and the old rejection text from the mint and rotate sections of access-commands.md. Both now say secrets always live in _token-secrets, and that passing --vault fails with Unknown option "--vault" (confirmed on swamp 20260928.230545). Readers who need a copy in another vault are pointed to 'Shared-vault handoff'. worker token create --vault is unchanged.

Sign in to post a ripple.