Skip to navigation

VM snapshots

A snapshot is a copy of a VM’s disks at one moment, taken when you ask for it. It’s like a save point in a game: before you upgrade the operating system or deploy a big change, you take a snapshot, and if things go wrong you go back to it. A snapshot can also be the starting point for new VMs that are copies of the original. Snapshots are kept until you delete them, and you pay for the storage they use.

When to use a snapshot

You want…Use
A copy right before a risky change: upgrade, migration, big deploySnapshot (this page)
A copy you keep for weeks or monthsSnapshot: it’s kept until you delete it
To clone a configured server into more VMsSnapshot, then create VMs from it
A copy every day or week, automaticallyBackups
SnapshotsBackups
TakenWhen you ask, as often as you likeDaily or Weekly, on a schedule
KeptUntil you delete them7 days (up to about 14 days), then deleted automatically
What’s capturedYou choose: root only, all volumes, or selected volumesRoot and all attached volumes
Restore modesReplace Current VM · Create New VM · Restore Selected DiskThe same

How it works

  1. You give the snapshot a name and choose a Capture Mode: which disks to include. The root disk is always included.
  2. IBEE copies the chosen disks at that moment. The VM keeps running.
  3. The snapshot appears as a recovery point on the VM’s Snapshots tab and on Tools → Snapshots.
  4. Later you can Restore it onto the same VM, into a new VM, or restore one disk.

Before you begin

  • A Cloud VM or GPU VM, and write access to its workspace.
  • Credit in your wallet: snapshot storage is billed per GB per month, for as long as the snapshot exists.
  • For consistent data, stop writes before you snapshot: inside the VM run sync, and stop or lock databases. IBEE doesn’t pause the VM’s filesystem, so a snapshot is like the disk after a sudden power cut (crash-consistent).

Key facts

QuestionAnswer
What’s captured?The root disk, plus the data volumes the Capture Mode includes: none, all, or the ones you tick
What isn’t?Memory and running programs. Volumes you leave out. Bare metal servers.
How often can I take one?Whenever you like, one at a time per VM. There’s no schedule.
How long is it kept?Until you delete it, including after the VM is deleted
What does it cost?Snapshot storage, per GB per month, prorated by the hour. The portal doesn’t show the price yet; the API lists it at GET /compute/plans/snapshot-storage.
Is it consistent?Crash-consistent. Run sync first; stop databases for a fully consistent copy.
Does a restore overwrite my VM?Replace Current VM and Restore Selected Disk roll the VM’s disks back in place: later changes are lost. Create New VM doesn’t touch the VM.
Can I use it in another location?Not yet. Snapshots can’t be copied to another location; new VMs from a snapshot are created in the original’s location.

Take a snapshot

1

Open the VM’s Snapshots tab

Open the VM and click Snapshots.

2

Name it and choose what to capture

Enter a Label (required) and an optional Description. Choose the Capture Mode: Root volume only, All attached volumes or Selective volumes.

3

Create it

Click Create Snapshot. The portal shows “Snapshot set created” and the snapshot appears under Recovery Points.

See Create a snapshot for the details, including the Take Snapshot button on Tools → Snapshots.

Where to find snapshots

PlaceUse it for
The VM’s Snapshots tabTake a snapshot; see the VM’s Recovery Points; Details, Restore and Delete
Tools → SnapshotsEvery snapshot in the workspace, with a search box (“Search by snapshot, VM, volume, or ID…”) and Take Snapshot. Each row’s Manage snapshot opens its details and Delete Snapshot.

On Tools → Snapshots, each row shows Snapshot (name and ID), Disks, Storage, Status (Available when ready) and Created. Restores start from the VM’s Snapshots tab.

Use the API or CLI

Per-VM snapshots are in the public API. GPU VMs use /compute/gpu-vms/{vm_id}/snapshots, /compute/gpu-vm-snapshots/... and the CLI’s ibee gpus snapshots.

TaskAPICLI
Take a snapshotPOST /compute/cloud-vms/{vm_id}/snapshotsibee vms snapshots create VM_ID NAME
List a VM’s snapshotsGET /compute/cloud-vms/{vm_id}/snapshotsibee vms snapshots list VM_ID
List every snapshot in the workspaceGET /compute/cloud-vm-snapshots
Get or delete a snapshotGET / DELETE /compute/cloud-vm-snapshots/{snapshot_set_id}ibee vms snapshots get / delete
RestorePOST /compute/cloud-vm-snapshots/{snapshot_set_id}/actions/restoreibee vms snapshots restore VM_ID SNAPSHOT_SET_ID

Taking a snapshot needs the snapshot storage price entry as billing_catalog: get it from GET /compute/plans/snapshot-storage?workspace_id=... and copy a selectable item’s billing_catalog.

Troubleshooting

You seeWhat it meansWhat to do
Create Snapshot is greyed outThe Label is empty, or another snapshot operation is runningEnter a label, or wait.
A snapshot operation is already in progress. Please wait.A snapshot restore or delete is runningWait for it to finish.
Select at least one attached data volume for a selective snapshot.Selective volumes with nothing tickedTick a volume, or choose another mode.
Only ready snapshot sets can be restored.The snapshot is still being created, or it failedWait until it’s Available, or take a new one.
”Snapshot set cannot be deleted while a restore is still running”A restore is using itWait for the restore to finish.
Snapshot charges after deleting a VMSnapshots are kept until you delete themDelete them on Tools → Snapshots.