Rowankeep
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.