features
Rollback
Roll back to a previous deployment version instantly.
Rollback#
Deployed a bug? Roll back to a previous version instantly. Runix keeps your previous deployment versions, so you can restore a known-good state without rebuilding.
How rollback works#
- Runix keeps previous Docker images for each deployment
- Rolling back swaps the current container with the previous version
- No rebuild required — it is instant
- Environment variables use their current values (not the values from the previous deploy)
Rollback from the dashboard#
1
Open your deployment
Go to your deployment page in the dashboard.
2
View deployment history
Click the "History" tab to see all previous versions.
3
Click rollback
Click the "Rollback" button next to the version you want to restore. The rollback happens immediately.
Rollback from the CLI#
You can also trigger a rollback from the command line.
CLI rollback
bash
# View deployment history
runix history my-api
# Rollback to the previous version
runix rollback my-apiRollback via the API#
API rollback
bash
curl -X POST https://api.runix.dev/deployments/a1b2c3d4-.../rollback \
-H "Authorization: Bearer $TOKEN"Rollback restores the previous container image but does NOT revert environment variable changes. If you changed env vars between deploys, the rolled-back version will use the current env vars.
Limitations#
- Database schemas are not rolled back — only the application container
- Rollback is only available for web services and workers, not databases
- The number of versions kept depends on your plan