Skip to content

docs: close the gaps the new-user walkthrough found - #38

Open
owenwahlgren wants to merge 1 commit into
mainfrom
docs/new-user-walkthrough-gaps
Open

docs: close the gaps the new-user walkthrough found#38
owenwahlgren wants to merge 1 commit into
mainfrom
docs/new-user-walkthrough-gaps

Conversation

@owenwahlgren

Copy link
Copy Markdown
Collaborator

Three documentation gaps surfaced by running the full playbook sequence as a first-time user on a fresh clone of main.

  • Playbook 01: the REMOTE_DATA_DIR mkdir/chown provisioning step (the only step that can need root; the preflight catches it but the fix was undocumented).
  • Playbook 03: the Docker bind-mount trap when compose starts before fleet targets renders, plus the recovery commands.
  • README: the fresh-creation funding minimum, stated where the runbook says to fund the address.

Verified: the walkthrough itself. Full playbook pass on a fresh three-chain deployment from main, all green.

Playbook 01 documents the one root-needing provisioning step: creating
REMOTE_DATA_DIR on a mount the ssh user cannot write. Playbook 03 warns
that compose-before-targets makes Docker create targets.json as a
directory, with the recovery. The README states the fresh-creation
funding minimum next to the runbook that needs it.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant