Skip to main content

Guides

Role-oriented walkthroughs for the three people most likely to open this site:

  • User guide — day-to-day operation of a provisioned stack: starting/stopping servers from the dashboard or Discord, reading the cost panel, tailing logs.
  • Maintainer guide — working on the code: monorepo layout, tests, lint, CI, release/deploy mechanics, load-bearing invariants not to break.
  • Submodule guide — the recommended layout for running the stack for real: wrap this repo as a git submodule inside a private parent repo that holds terraform.tfvars, state, and anything else secret. Includes an interactive scaffolder that generates the wrapper Makefile and config files for you.
  • S3 tfvars storage guide — the optional versioned S3 backend for terraform.tfvars: bootstrapping, day-to-day pull/push/diff, migrating an existing parent repo, and troubleshooting sync failures.

The Setup guide is still the first stop if none of the above has happened yet.