Volume snapshots
Create, restore, edit and schedule snapshots of custom storage volumes.
A volume snapshot is a point-in-time copy of a custom volume. Snapshots let you roll a volume back to an earlier state, for example before an upgrade or a risky data migration. For snapshots of whole instances, see Instance snapshots.
Snapshot creation can be blocked by project policy (restricted.snapshots). If the snapshot buttons are disabled in your project, ask your administrator.
Create a snapshot
- Go to Storage → Volumes and open the volume.
- Go to the Snapshots tab and click Create snapshot.
- Optionally set a name and an expiry date and time. If you leave the name empty, the volume's snapshot name pattern applies. If you set an expiry, the snapshot is deleted automatically once it passes.
- Click Create.
Restore a snapshot
Restoring overwrites the volume's current contents with the snapshot's contents.
- On the volume's Snapshots tab, find the snapshot.
- Click Restore and confirm. This action cannot be undone and can result in data loss — data written after the snapshot is discarded.
Edit a snapshot
Use the Edit action on a snapshot to rename it or change its expiry date.
Delete snapshots
Delete a single snapshot with its Delete action, or select multiple snapshots in the table and use bulk delete. The table supports search and pagination, so you can clean up old snapshots in batches.
Scheduled snapshots
You can snapshot a volume automatically on a schedule. On the volume's Snapshots tab, click See configuration and set:
| Setting | Key | Notes |
|---|---|---|
| Snapshot name pattern | snapshots.pattern | Template used to name automatic (and unnamed manual) snapshots. |
| Expire after | snapshots.expiry | How long each automatic snapshot is kept, for example 7d. |
| Schedule | snapshots.schedule | Cron expression (<minute> <hour> <day-of-month> <month> <day-of-week>). |
For example, 0 3 * * * snapshots the volume every day at 03:00. Combine a schedule with an expiry so old snapshots are pruned automatically.