What to enter
Paste the output of restic snapshots --json as it is. The simulator reads each snapshot's ID, time, host, paths, and tags.
Pick the timezone your backups run in. Daily, weekly, monthly, and yearly rules count calendar days in that timezone, so a backup just after midnight can land on a different day in UTC.
Group snapshots by applies each rule separately to every host, path set, or tag set. restic itself groups by host and paths together, which this tool can't combine. If one host backs up several paths in separate jobs, compare the result with a dry run.
20 nightly backups with 7 daily, 4 weekly, and 6 monthly
Example
One snapshot a night from 1 to 20 September 2026, grouped by host, timezone Europe/Berlin.
The result is Kept 10 of 20 snapshots. The 7 newest are daily keeps, and 20 September also counts for its week and month. 13 and 6 September are the newest in their weeks. 1 September is kept as the oldest snapshot, because the history isn't long enough to fill 4 weeks and 6 months.
pruned means no rule picked that snapshot. Nothing is deleted.
How does restic forget decide what to keep?
Each rule picks snapshots on its own, and a snapshot stays if any rule picks it. Everything else is forgotten. The restic forget documentation describes each rule.
--keep-last nkeeps the newest n snapshots.--keep-daily nkeeps the newest snapshot from each of the last n days that have one.--keep-weekly ndoes the same for weeks.--keep-monthly ndoes the same for months.--keep-yearly ndoes the same for years.
Weeks run from Monday to Sunday. One snapshot can satisfy several rules at once, so a policy of 7 daily and 4 weekly can keep fewer than 11 snapshots.
Does --keep-daily 7 keep the last 7 days?
No. It keeps the newest snapshot from the last 7 days that have a snapshot. Days with no backup don't count, so after a week of missed backups, --keep-daily 7 still keeps 7 snapshots that reach further back.
To keep everything within a time span instead, restic has --keep-within and --keep-within-daily, which take a duration such as 7d. This simulator doesn't model those, or --keep-hourly and --keep-tag.
Why is my oldest snapshot kept?
When there aren't enough snapshots to fill a rule, restic also keeps the oldest one and marks it oldest. With 20 days of backups and --keep-monthly 6, only one month has snapshots, so the oldest stays as well.
Why are some snapshots kept that I didn't expect?
Check the grouping first. restic applies the policy to each group of host and paths separately, so every backup job keeps its own full set. A snapshot with a different path list counts as a separate group, even on the same host.
To group differently, use --group-by, such as --group-by host or --group-by paths,tags.
Does forget free disk space?
Not by itself. forget removes snapshots from the list, and prune deletes the data that only those snapshots used. Add --prune to forget to run both. Pruning locks the repository, so backups can't run while it works.
The simulator can't tell how much space you'll get back, because snapshots share most of their data.
For where backups fit in a home server setup, see the course chapter on backups before serious apps.