Reference
Canonical technical documentation. Guides link here; avoid duplicating full schemas in guides.
Configuration and job model
| Document | Topic |
|---|---|
| configuration.md | maand.conf, bucket.conf, bucket.jobs*.conf, vars.conf, prerequisites |
| manifest.md | manifest.json schema |
| resources-and-placement.md | Memory, CPU bounds vs reservations, selectors, worker capacity |
| deployment-sequence.md | Demands, deployment_seq, deploy waves |
| templates.md | .tpl rendering at deploy |
| certs.md | TLS CA and job certificates |
KV and hooks
| Document | Topic |
|---|---|
| kv/README.md | KV index |
| kv/namespaces.md | Keys, layers, examples |
| kv/persistence.md | Writes, purge, access rules |
| hook-api.md | Runtime HTTP API, env vars, Python/Bun helpers |
Observability
| Document | Topic |
|---|---|
| observability/logging.md | Log files, formats, maand logs show, terminal output |
CLI
| Document | Command / topic |
|---|---|
| cli/commands.md | Full CLI index |
| cli/build.md | maand build |
| cli/deploy.md | maand deploy |
| cli/health-check.md | maand health_check |
| cli/hooks.md | Hook events, maand hooks |
| cli/job.md | maand job |
| cli/run-command.md | maand run_command |
| cli/collect.md | maand collect facts, maand collect uptime |
| cli/gc.md | maand gc |
| cli/info.md | maand info, maand cat |