# Kindling

> Self-hosted PaaS on microVMs. Push code, get production.

## Docs

- [Architecture](https://docs.kindling.systems/concepts/architecture.md): The high-level control-plane model behind Kindling.
- [Reconcilers](https://docs.kindling.systems/concepts/reconcilers.md): How Kindling drives state changes without imperative deploy pipelines.
- [Runtimes](https://docs.kindling.systems/concepts/runtimes.md): How Kindling chooses and uses Cloud Hypervisor, Apple Virtualization, and crun.
- [First Deploy](https://docs.kindling.systems/getting-started/first-deploy.md): The shortest path from a running Kindling server to a live app.
- [Linux Quickstart](https://docs.kindling.systems/getting-started/linux.md): Bring up Kindling on a single Linux host using the repo-supported path.
- [Overview](https://docs.kindling.systems/getting-started/overview.md): What Kindling is, where it fits, and how to approach the docs.
- [Deployments and Previews](https://docs.kindling.systems/guides/deployments-and-previews.md): How production deploys, preview environments, and live updates work today.
- [Domains and Routing](https://docs.kindling.systems/guides/domains-and-routing.md): Public hostnames, the edge proxy, and current routing behavior.
- [Projects and Services](https://docs.kindling.systems/guides/projects-and-services.md): Understand the project model Kindling exposes in the API and dashboard.
- [Secrets and Volumes](https://docs.kindling.systems/guides/secrets-and-volumes.md): Current secret handling and persistent storage constraints.
- [Kindling Docs](https://docs.kindling.systems/index.md): Start here for deployment guides, operator setup, architecture, and reference documentation.
- [Backup and restore](https://docs.kindling.systems/operate/backup-and-restore.md): Operator procedures for PostgreSQL control-plane recovery and project volume backups.
- [Control-plane backup and disaster recovery](https://docs.kindling.systems/operate/control-plane-backup-and-dr.md): What to back up for Kindling control-plane recovery versus workload volumes.
- [Operations runbook](https://docs.kindling.systems/operate/operations-runbook.md): Index of install, upgrade, backup, maintenance, and audit tasks for self-hosted Kindling.
- [Production foundations acceptance](https://docs.kindling.systems/operate/production-foundations-acceptance.md): Acceptance criteria for Operator Controls and Recovery before Reliability Validation.
- [Production Setup](https://docs.kindling.systems/operate/production-setup.md): The main production shape for a public Kindling deployment.
- [Server Drain](https://docs.kindling.systems/operate/server-drain.md): What draining a host means in the current product and how it differs from live migration.
- [Topology and Hostnames](https://docs.kindling.systems/operate/topology-and-hostnames.md): Supported production topology shapes and public hostnames for Kindling.
- [Troubleshooting](https://docs.kindling.systems/operate/troubleshooting.md): Common bring-up and runtime issues for current Kindling deployments.
- [API Overview](https://docs.kindling.systems/reference/api-overview.md): The main REST API resource groups currently exposed by Kindling.
- [CLI Reference](https://docs.kindling.systems/reference/cli.md): High-level reference for the current Kindling CLI command groups.
- [Configuration Reference](https://docs.kindling.systems/reference/configuration.md): Important runtime flags, build inputs, and environment knobs to know about.

## OpenAPI Specs

- [openapi](https://docs.kindling.systems/api-reference/openapi.json)