Operations

Running Sandswap after it is deployed — for operators and platform engineers. For the deployment itself, start at Deployment.

  1. Configuration — per-component reference: gateway, sandlot, boxout, sandns, warden.
  2. sandctl — the client CLI: gateway HTTPS API client, DNS queries, pool/health views, and the deployer-written client contract.
  3. etcd — the coordination-layer runbook: sizing, compaction, defragmentation, backup/restore, NOSPACE recovery.
  4. Storage Requirements — the contract a shared filesystem must satisfy, pinned service identities, the NFS recipe.
  5. Template Contract — the mode/ownership contract a rootfs template must satisfy, and the template-tool that normalizes and validates it: validate a template tree, check-store a template store.
  6. Observability — latency fields, /stats, per-component log surfaces, debug gating.
  7. Troubleshooting — reading /stats, common failures, crash recovery expectations, sandns day-2 operations.
  8. Release — how releases are cut, what the release package contains, and how to consume it.

Table of contents