Skip to main content

​
Create a Snapshot

Use the interactive menu: 
tnr snapshot create
Or specify the instance and name directly: 
tnr snapshot create --instance-id 0 --name my-environment
Snapshotting happens in the background—you can continue using your instance immediately. The snapshot captures the exact state of the persistent disk at the moment you initiated it.
Ephemeral storage (/ephemeral) is not included in snapshots. Back up any important data from ephemeral storage before snapshotting.
There is a limit of 50 snapshots.
Snapshots can only be created from instances in RUNNING state.

​
List Snapshots

View all your snapshots with their status, size, and creation date: 
tnr snapshot list
Status values:
  • READY: Snapshot is complete and can be used
  • CREATING: Snapshot is still being created
  • FAILED: Snapshot creation failed

​
Delete a Snapshot

Remove snapshots you no longer need: 
# Interactive selection
tnr snapshot delete

# Delete by name
tnr snapshot delete my-environment
Deleting a snapshot is permanent and cannot be undone.

​
Restore from a Snapshot

When creating a new instance, your snapshots appear alongside templates: 
tnr create
# Select your snapshot in the "Templates" step
The new instance’s disk size must be at least as large as the snapshot. The CLI enforces this automatically.
Restoring from a snapshot can take up to 8 minutes per 100GB of data. The instance shows as RESTORING during this time.

​
Best Practices

  1. Name snapshots descriptively: Include the project, date, or purpose (e.g., llama-finetuned-jan2026)
  2. Clean up unused snapshots: To minimize your bill, remove snapshots you no longer need.

​
Snapshots vs External Backups

Snapshots are great for quickly restoring your environment, but they’re meant for convenience rather than long-term data security. We do not provide explicit guarantees about snapshot durability. For long-term data preservation, consider using:
  • GitHub for code and configuration
  • Local downloads for important outputs
  • Cloud storage (R2, Google Drive) for large files
To learn about optimizing the a snapshot for faster creation and restoration, refer to our Speeding Up Snapshots guide.