Docs / Sites / Rollback a Deployment

Rollback a Deployment

Published · Last updated: May 2026 · 2 min read

Who this is for

Users who deployed a change to their site and need to undo it because of an error, visual regression, or broken functionality.

What Rollback Means in CloudAIPilot

A rollback returns your site files to a previous deployment's state. For git-connected sites, this means resetting to a previous commit. For non-git sites with file-based deployments, it means restoring from the last known good snapshot if one was taken.

Rollback for Git-Connected Sites

If your site has git deploy configured (see KB-03-08: Git Settings and Webhook Deploy):

  1. Open the site detail → Deployments tab.
  2. Find the deployment you want to roll back to (a previously successful plan).
  3. Click Rollback to this version.
  4. Confirm. CloudAIPilot creates a new deployment plan that runs git reset --hard and then reloads Nginx / restarts the application.

The rollback itself is a new deployment plan — you can monitor its progress in the Activity Center.

If No Rollback Is Available

If git deploy is not configured, or if the previous deployment was the first one (no previous version), the Rollback option will be unavailable.

In this case:

  • If you have a file backup, restore from it — see KB-05: Backups and Restore.
  • If you have a site clone (e.g., a staging copy), you can manually compare files.
  • Use the Terminal to manually revert files.

Preventing Difficult Rollbacks

Best practices:

  • Always connect git deploy and use versioned commits — this gives CloudAIPilot a full history to roll back to.
  • Take a manual backup before any major deployment.
  • Use the site clone feature to create a staging copy before large changes — see KB-03-09: Clone a Site.
  • Keep your deployment commits small and incremental.

What Success Looks Like

After rollback, the site shows the previous version in a browser. The deployment history shows the rollback as a new completed plan entry.

Related Articles