Restoring from a Backup

Each backup run creates a snapshot in the backup repository. You can browse available snapshots and restore any of them directly from the ServerPlane dashboard.

Viewing Snapshots

  1. Navigate to Backups and click the backup you want to restore from.
  2. Switch to the Snapshots tab.
  3. Click Load Snapshots to fetch the list from the backup repository.

The snapshot list shows each snapshot with:

  • Snapshot ID — a short identifier for the snapshot.
  • Date and time — when the snapshot was taken.
  • Tags — any tags associated with the snapshot (e.g., scope or app name).

Click Refresh Snapshots at the bottom of the list to reload the data from the repository.

Restoring a Snapshot

  1. Find the snapshot you want to restore and click the Restore button next to it.
  2. A confirmation prompt appears. The snapshot will be extracted to a temporary directory on the server so you can review the files before moving them into place.
  3. Click Confirm to start the restore.
  4. The button changes to "Restoring..." while the operation runs.
  5. Once complete, a success or failure message appears inline.

Restored files are placed in a temporary directory on the server so you can review them before moving them into place. This avoids accidentally overwriting live data.

Restore History

Each restore operation is tracked as part of the backup's history (visible in the History tab). Completed restores show the snapshot ID and timestamp, while failed restores include an error message to help with troubleshooting.

Tips

  • Always verify the snapshot date before restoring to make sure you are recovering the right version of your data.
  • After restoring, use the File Manager or Web Terminal to move files from the temporary directory to their final location.
  • Snapshots are immutable. Restoring does not modify or remove the original snapshot from the repository.