Schedules

Run backups automatically, and control how long old snapshots are kept

A backup only protects you if it keeps running. Schedules do that.

In Immich

Open the backups page, select Configure, then Schedule, and turn on Run backups automatically.

Pick a Frequency of daily, weekly or monthly. We recommend that you keep the default time and day, as this helps us optimise your backup performance. By default, we'll perform your backup between 03:00 and 04:00.

In the standalone app

Schedules are separate from backups, so one schedule can run several backups in order.

  1. Go to Schedules and select Create new schedule.
  2. Give it a Name.
  3. Pick a Frequency. New schedules start on the installation's daily default. Choose Custom to enter a cron expression.
  4. Add the backups it should run, in the order you want them.
  5. Save.

Common expressions:

The five fields are minute, hour, day of month, month and day of week.

A schedule shows its expression, when it last ran, and whether it is paused. Its menu has Pause, Resume, Configure and Delete.

What happens when a schedule fires

The backups in a schedule run one after another, in the order you arranged them.

  • If the machine is off or the container is not running when a schedule is due, that run is simply missed. There is no catch-up run afterwards.
  • If a backup from the previous run is somehow still going, that backup is recorded as failed for this run rather than starting twice.
  • The "last ran" time is when the schedule started, not when it finished.

How long snapshots are kept

After each run, snapshots older than the retention period are removed and the space is reclaimed. The default keeps 60 days.

In Immich you can change this under Configure, then Storage, in Delete old backups: 15, 30, 60 or 90 days, only the latest two backups, or keep everything.

In the standalone app the 60 day default applies and there is no setting for it yet. If you need to keep snapshots for longer than that today, use a write-once backup, which never deletes anything.