Skip to main content
Updated October 19, 2026 A rollback puts your app back on the code of an earlier deploy that went live. Raff runs that deploy’s built image again as a new deploy, without building anything, so it is the fastest way back after a bad release.

Before you start

  • An app with at least one earlier deploy that went live. A deploy that failed cannot be a rollback target.

Roll back to the previous deploy

Open the app. On Overview, Live deploy, click Roll back. The app goes back to the deploy that was live before the current one. There is no confirmation step: the rollback starts when you click.

Roll back to an older deploy

1

Open Deploys

Open the app and go to Deploys. Each row shows the deploy number, its state, the commit, what started it, how long it took and when.
2

Pick the deploy

Find the deploy you want. Deploys that were live and then replaced show the state Replaced. Click Log on a row to check what it built.
3

Roll back

Click Roll back on that row.
TODO: Deploys tab with a Replaced deploy and its Roll back button

What happens

  • The rollback runs as a new deploy with the trigger rollback. It goes live the same way as any deploy: once the app answers its health check, or its port opens when it has none. Until then the current deploy keeps serving.
  • Only the code goes back. Environment variables, scaling and other settings stay as they are now.
  • On an app from GitHub, the next push to the branch deploys that commit as usual. Fix or revert the change in Git before you push again.
  • To go back to the newer code, roll back to that deploy the same way.

Do it from your tools

$APP_ID is the app’s ID from List app services or raff apps list. $RAFF_API_KEY is an API key. API: List deployments, Roll back to a deployment
Pick a deploy with status live or superseded. CLI

Next steps

View logs, metrics and a shell

Find out what broke.

Preview pull requests

Try changes before they reach the live app.
Last modified on October 19, 2026