Skip to main content

​
Subcommands

CommandDescription
capsule schedule addAdd a new schedule for a connection
capsule schedule listList all configured schedules
capsule schedule removeRemove a schedule

​
capsule schedule add

capsule schedule add
Launches an interactive prompt to create a new schedule. You will be asked to:
  1. Select the connection to schedule
  2. Enter a cron expression for the backup frequency
  3. Set the number of backups to retain

​
Cron expression examples

ExpressionMeaning
0 2 * * *Every day at 2:00 AM
0 2 * * 0Every Sunday at 2:00 AM
0 */6 * * *Every 6 hours
0 2 1 * *First day of every month
Use crontab.guru to build and verify cron expressions.

​
Retention

Retention controls how many backups to keep per connection. When the limit is reached, the oldest backup is deleted automatically. The minimum is 1, and your plan determines the maximum retention period.

​
capsule schedule list

capsule schedule list
Lists all active schedules with their connection name, cron expression, and retention count. 
Connection       Schedule        Retention
──────────────── ─────────────── ─────────
prod-postgres    0 2 * * *       7
staging-mysql    0 */6 * * *     3

​
capsule schedule remove

capsule schedule remove
Prompts you to select a schedule to remove. The connection itself is not affected — only the schedule is deleted.

​
Notes

  • Schedules are stored in the local config file and executed by the Capsule daemon
  • The daemon must be running (via capsule service) for scheduled backups to fire
  • Schedule activity syncs to your dashboard in real time