Skip to main content

​
Usage

capsule backup list
capsule backup list --connection <label>

​
What it does

Fetches all completed backups from your Capsule cloud storage and prints them with a short 10-character ID, connection name, size, and date. 
  550e8400e2   my-postgres   1.2 MB   2026-07-01 02:00 UTC
  a3f91bc4d8   my-postgres   1.1 MB   2026-06-30 02:00 UTC
  ff02a19c71   my-mysql      840 KB   2026-06-29 03:00 UTC
Use the short ID with capsule download to download and decrypt a backup: 
capsule download 550e8400e2

​
Flags

FlagDescription
--connection, -cFilter the list to a single connection by its label

​
About short IDs

Each backup is stored with a full UUID internally (e.g. 550e8400-e29b-41d4-a716-446655440000). The list displays the first 10 hex characters without hyphens for convenience. Both formats are accepted by capsule download — you can also paste the full UUID if you have it. If two backups happen to share the same short prefix (extremely unlikely), capsule download will tell you and ask you to provide more characters. You can also copy a backup’s short ID directly from the Backups page in the dashboard using the copy button next to each row.

​
See also