Documentation Index

Fetch the complete documentation index at: https://docs.kindling.systems/llms.txt

Use this file to discover all available pages before exploring further.

​

Operations runbook

​

Install and bootstrap

• Production Setup — first node, worker join, WireGuard mesh env.
• Topology and Hostnames — DNS and hostname expectations.

​

Upgrade

1. Read release notes for the target kindling version.
2. Back up PostgreSQL (control plane) on a schedule compatible with your rollback plan.
3. Replace the kindling binary on each host (control plane and workers) with the same version skew policy your team allows (prefer minimal skew).
4. Restart systemd units (kindling@api, kindling@edge, kindling@worker, …) in an order that keeps the API reachable.
5. Validate: Production Setup checklist, deploy a canary workload.

​

Backup and disaster recovery

• Control-plane backup and DR — what must be protected.
• Backup and restore — Postgres vs volumes.
• Repo: docs/control-plane-backup-and-dr.md

​

Maintenance: drain and reactivate

• Server Drain — evacuation semantics vs live migration.
• Platform admins use POST /api/servers/{id}/drain and POST /api/servers/{id}/activate (see API reference).

​

Audit trail

SELECT action, resource_type, resource_id, details, created_at
FROM cluster_audit_events
ORDER BY created_at DESC
LIMIT 50;

​

Troubleshooting

• Troubleshooting

​

Milestone acceptance

• Production foundations acceptance