Skip to main content
← Back to list
01Issue
BugShippedSwamp Club
Assigneesstack72

Relationships

#721 remote-execution.md tutorial claims hello-world repo already has a vault configured, but it doesn't

Opened by sntxrr · 6/20/2026· Shipped 6/21/2026

The remote-execution tutorial (https://swamp-club.com/manual/tutorials/remote-execution) says:

"You have a Swamp repository with at least one vault configured. The hello-world tutorial covers both of these."

implying that completing the hello-world tutorial leaves you with a vault already set up. It does not — the hello-world tutorial (https://swamp-club.com/manual/tutorials/hello-world) never creates or configures a vault; it only covers models, running them, querying data, and composing workflows. swamp repo init does create an empty vaults/ directory, but no vault is actually configured inside it.

Repro:

  1. Follow the hello-world tutorial to set up swamp-hello-world.
  2. Copy the remote-execution tutorial's first command verbatim: swamp worker token create build-node --duration 1h
  3. Instead of creating the token, swamp errors: FTL error Error: "No vaults are configured — the token plaintext must be stored in a vault. Create one with: swamp vault create <type> <name>"

Expected: either the remote-execution tutorial should include the swamp vault create ... step before the worker token example, or the hello-world tutorial should actually configure a vault as the linked text claims.

02Bog Flow
OPENTRIAGEDIN PROGRESSSHIPPED+ 1 MOREASSIGNED+ 2 MOREREVIEW+ 3 MOREPR_MERGED+ 1 MORECONTRIBUTOR_NOTIFIED

Shipped

6/21/2026, 3:32:25 PM

Click a lifecycle step above to view its details.

03Sludge Pulse
stack72 assigned stack726/21/2026, 3:17:54 PM
Editable. Press Enter to edit.

stack72 commented 6/21/2026, 3:32:45 PM

Thanks @sntxrr for reporting this! The fix has been merged and a release is on its way. We appreciate your contribution to swamp.

Sign in to post a ripple.