# Orbit Handbook

## Field Notes

- [Orbit 0.4: Dry-Run Diffs by Default](https://orbit-handbook.sitesmojo.com/blog/orbit-04-dry-run-diffs-by-default.md): Deploys now start with the diff: what 0.4 changes, why, and the one-flag migration.
- [How to Mirror Production in Staging](https://orbit-handbook.sitesmojo.com/blog/how-to-mirror-production-in-staging.md): A three-line overlay, promote-not-rebuild, and a nightly drift check.
- [Dogfooding Orbit on Orbit](https://orbit-handbook.sitesmojo.com/blog/dogfooding-orbit-on-orbit.md): Orbit deploys Orbit - what shipped because our own deploys hurt, and what that costs.
- [Introducing Orbit](https://orbit-handbook.sitesmojo.com/blog/introducing-orbit.md): Why we built Orbit: deploys that start as a readable plan and end with an instant undo.

## Orbit Handbook

- [Welcome](https://orbit-handbook.sitesmojo.com/docs/welcome.md): What Orbit is, the three ideas behind it, and where to start reading.
- [Getting Started](https://orbit-handbook.sitesmojo.com/docs/getting-started.md): Install the CLI, describe a service, and ship a first deploy in five minutes.
- [Installation](https://orbit-handbook.sitesmojo.com/docs/installation.md): Install Orbit on macOS, Linux and CI runners, plus authentication and upgrades.
- [Configuration](https://orbit-handbook.sitesmojo.com/docs/configuration.md): The complete orbit.yaml reference: environments as overlays, health checks, secrets.
- [Deployments](https://orbit-handbook.sitesmojo.com/docs/deployments.md): The release lifecycle: plan, diff, apply, verify, live - and why releases are immutable.
- [Rollbacks](https://orbit-handbook.sitesmojo.com/docs/deployments/rollbacks.md): Undo a release in seconds: a pointer flip, not a redeploy - and what rollback will not do.
- [Zero-Downtime](https://orbit-handbook.sitesmojo.com/docs/deployments/zero-downtime.md): Blue-green and rolling strategies, and how health checks gate every traffic switch.
- [CLI Reference](https://orbit-handbook.sitesmojo.com/docs/cli-reference.md): Every Orbit command, the flags worth knowing, and the exit codes CI can rely on.
- [Troubleshooting](https://orbit-handbook.sitesmojo.com/docs/troubleshooting.md): The failures people actually hit - verify timeouts, drift, protected releases - and the fixes.
- [Roadmap](https://orbit-handbook.sitesmojo.com/docs/roadmap.md): What is shipping now, next and later - and the things Orbit deliberately will not become.