Skip to main content
npx dbdock list [options]
Shows backups from your configured storage provider. When you have more than 50 backups, DBdock auto-filters to keep the output readable.

​
Options

OptionDescription
--recent <N>Show the N most recent backups
--search <keyword>Filter by keyword in backup ID
--days <N>Show backups from the last N days
--limit <N>Limit total results

​
Examples

​
Most recent

npx dbdock list --recent 10

​
Last week

npx dbdock list --days 7

​
Search by keyword

npx dbdock list --search "pre-deploy"
Matches any backup whose ID contains “pre-deploy”.

​
Combine filters

npx dbdock list --days 30 --limit 20
Last 30 days, capped at 20 results.

​
Output

┌────────────────────────────────────┬──────────┬───────────┬─────────────────────┐
│ ID                                 │ Size     │ Encrypted │ Created             │
├────────────────────────────────────┼──────────┼───────────┼─────────────────────┤
│ backup-2026-04-16-08-00-00-abc123  │ 45.2 MB  │ ✓         │ 2026-04-16 08:00:00 │
│ backup-2026-04-15-08-00-00-def456  │ 45.1 MB  │ ✓         │ 2026-04-15 08:00:00 │
│ backup-2026-04-14-08-00-00-ghi789  │ 44.8 MB  │ ✓         │ 2026-04-14 08:00:00 │
└────────────────────────────────────┴──────────┴───────────┴─────────────────────┘

Total: 3 backup(s) — 135.1 MB

​
Scripting

The command writes human-readable output by default. For scripting, use the SDK which returns structured data.