# Commands to list and inspect database backups

**Project:** CLI | **Votes:** 1
**URL:** https://roadmap.ploi.io/projects/8-cli/items/1654-commands-to-list-and-inspect-database-backups

---

The Ploi CLI covers servers, sites, cronjobs, daemons, databases and logs, but has no commands for database backups. After migrating a site to a new server, I can verify the site, its cronjob and its deploy from the CLI, but to check that the database backup is configured and actually running I have to open the panel.

Proposed commands, read-only first:

- backup:list [--server=] [--site=]: list database backup configurations with ID, database(s), destination (S3, Dropbox, ...), frequency, retention and status (active/paused).
- backup:show <id>: details of one backup configuration, including the time and status of the last run (success/failed) and the size of the last backup.
- backup:runs <id>: the most recent runs with timestamp, status and size, so a failed or missing backup can be spotted.

Nice to have, as write actions:

- backup:run <id>: trigger a backup now (for example right before a migration or a major upgrade).
- backup:toggle <id>: pause or resume a backup.

Why this matters:

- Verifying backups is part of every server migration or upgrade checklist, and it is the one step that still needs the panel.
- We use the CLI with a read-only API token for automated checks maintenance. Read-only backup commands would let us confirm that backups exist and succeed without handing out a token with write access.
- Database backups seem to be available in the Ploi API already, so this would mainly mean exposing them in the CLI.