Docs / Concepts
Snapshots and retention
Every run of rowankeep backup makes a snapshot: a complete picture of the paths you gave it at that moment. Because unchanged data is stored only once, a snapshot that differs little from the one before costs almost nothing.
Listing snapshots
$ rowankeep snapshots
ID Time Host Tags Paths
4f1c9a2e 2026-09-26 02:00:13 web-01 daily /etc /srv
a83b51d0 2026-09-25 02:00:09 web-01 daily /etc /srv
Keeping the right ones
Snapshots pile up, so sooner or later you want to remove old ones. The retention policy says which to keep; everything else is removed by rowankeep prune:
[retention]
keep_daily = 14
keep_weekly = 8
keep_monthly = 12
A snapshot kept by any rule stays. With the policy above you can go back to any of the last two weeks day by day, and to any month of the last year.
Run rowankeep prune --dry-run first when you change the policy. It lists the snapshots that would go without removing anything.