Skip to main content

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.

Reconcilers

Reconcilers are the heart of Kindling.

Flow

  1. A row changes in PostgreSQL.
  2. The WAL listener receives that change through logical replication.
  3. The relevant reconciler is scheduled.
  4. The reconciler reads current state and desired state.
  5. It makes the minimum changes needed to converge the system.
  6. Failures retry after a short delay.

Why This Matters

This keeps Kindling reactive and resilient:
  • deployments do not depend on one long, fragile imperative job
  • server-state changes can be retried naturally
  • the same model covers builds, domains, instances, previews, and more

Places This Shows Up

  • deployment creation and scaling
  • preview environment cleanup
  • domain routing updates
  • server drain and replacement behavior