Orbit Handbook
MarkdownOpen in ClaudeOpen in ChatGPT

Rollbacks

Bad releases happen. Orbit's contract: rolling back is faster than
explaining what went wrong.

Undo the last release

orbit rollback --env production

That is the whole procedure. A rollback is a pointer flip to the previous
release - no rebuild, no redeploy, no waiting on CI. It completes in about a
second.

Roll back to a specific release

orbit releases --env production   # list what is on disk
orbit rollback --env production --to 41

release.keep in configuration controls how many
releases stay addressable (default 10).

What a rollback does not do

Practice it

A rollback you have never run is a rollback you do not have. Once a quarter,
roll staging back on purpose:

orbit rollback --env staging && orbit status --env staging

If that makes anyone nervous, that nervousness is the finding.