Explain automatic root snapshot retention in Snapshots settings #21

Closed
opened 2026-09-30 01:30:43 +08:00 by Breadway · 6 comments
Owner

Add a short retention note to Settings > Snapshots for BOS installs. Root Snapper cleanup keeps 2-20 normal snapshots and 4-10 important snapshots, with space-aware cleanup configured to keep at least 20% of the filesystem free and cap snapshot usage at 50% when the filesystem has Btrfs quota accounting enabled. Explain that cleanup can retain fewer snapshots when space is low.

This UI copy follows the BOS-27 retention change in Breadway/bos#56. Link this issue back to BOS-27 when appropriate.

Add a short retention note to Settings > Snapshots for BOS installs. Root Snapper cleanup keeps 2-20 normal snapshots and 4-10 important snapshots, with space-aware cleanup configured to keep at least 20% of the filesystem free and cap snapshot usage at 50% when the filesystem has Btrfs quota accounting enabled. Explain that cleanup can retain fewer snapshots when space is low. This UI copy follows the BOS-27 retention change in https://git.breadway.dev/Breadway/bos/pulls/56. Link this issue back to BOS-27 when appropriate.
Author
Owner

PR: #22. Added the Snapper retention note to Settings > Snapshots, including the configured ranges, quota-aware space limits, and low-space caveat. npm run check and npm run build passed. Linked BSET-20 as related to BOS-27.

PR: https://git.breadway.dev/Breadway/bos-settings/pulls/22. Added the Snapper retention note to Settings > Snapshots, including the configured ranges, quota-aware space limits, and low-space caveat. `npm run check` and `npm run build` passed. Linked BSET-20 as related to BOS-27.
Author
Owner

Reviewed PR #22. Acceptance criteria as I read them: Settings > Snapshots must explain the 2 to 20 regular and 4 to 10 important snapshot ranges, quota-aware 20% free-space and 50% snapshot limits, and the low-space caveat. frontend/src/lib/views/Snapshots.svelte:66 states all three. The copy is clear and check / check (push) is green; PR #22 is mergeable.

Holding the merge for the stated BOS-27 dependency. PR #56 is still open, and origin/main in iso/airootfs/etc/calamares/post-install.sh:364-365 still sets the old 10 regular / 5 important values. Landing this UI now would describe retention that BOS installs do not yet configure. Keep BSET-20 in review until BOS-27 lands, then recheck CI and merge.

Reviewed PR #22. Acceptance criteria as I read them: Settings > Snapshots must explain the 2 to 20 regular and 4 to 10 important snapshot ranges, quota-aware 20% free-space and 50% snapshot limits, and the low-space caveat. `frontend/src/lib/views/Snapshots.svelte:66` states all three. The copy is clear and `check / check (push)` is green; PR #22 is mergeable. Holding the merge for the stated BOS-27 dependency. PR #56 is still open, and `origin/main` in `iso/airootfs/etc/calamares/post-install.sh:364-365` still sets the old 10 regular / 5 important values. Landing this UI now would describe retention that BOS installs do not yet configure. Keep BSET-20 in review until BOS-27 lands, then recheck CI and merge.
Author
Owner

Reviewed PR #22 at head 95bbfebc28fab7356f64acbfc6be956ec9bbb8ef. Acceptance criteria: (1) state the 2-20 normal and 4-10 important snapshot ranges, (2) explain the 20% free-space target and 50% snapshot-space cap when Btrfs quota accounting is enabled, and (3) warn that low space can reduce retained counts. The added hint in frontend/src/lib/views/Snapshots.svelte:66 covers all three. The diff is copy-only; no behavior test was added, and CI check / check (push) is green. PR #22 is mergeable.

Holding BSET-20 in REVIEW because its stated dependency is unresolved: BOS-27 is still DOING, PR #56 is open and currently not mergeable, and BOS main still sets the old 10 normal / 5 important values. BOS-27 also has not completed its ten-transaction acceptance check. Recheck this PR after BOS-27 lands, then confirm CI and merge.

Reviewed PR #22 at head `95bbfebc28fab7356f64acbfc6be956ec9bbb8ef`. Acceptance criteria: (1) state the 2-20 normal and 4-10 important snapshot ranges, (2) explain the 20% free-space target and 50% snapshot-space cap when Btrfs quota accounting is enabled, and (3) warn that low space can reduce retained counts. The added hint in `frontend/src/lib/views/Snapshots.svelte:66` covers all three. The diff is copy-only; no behavior test was added, and CI `check / check (push)` is green. PR #22 is mergeable. Holding BSET-20 in REVIEW because its stated dependency is unresolved: BOS-27 is still DOING, PR #56 is open and currently not mergeable, and BOS `main` still sets the old 10 normal / 5 important values. BOS-27 also has not completed its ten-transaction acceptance check. Recheck this PR after BOS-27 lands, then confirm CI and merge.
Author
Owner

This retention copy depends on BOS-27. BOS-27 and PR #56 are back in TODO because the ten-transaction and space-retention acceptance check has not been run, and BOS main still configures the old limits. Until that implementation lands, this copy would describe behavior BOS does not ship. Returning this item to TODO; re-review after BOS-27 is merged.

This retention copy depends on BOS-27. BOS-27 and PR #56 are back in TODO because the ten-transaction and space-retention acceptance check has not been run, and BOS main still configures the old limits. Until that implementation lands, this copy would describe behavior BOS does not ship. Returning this item to TODO; re-review after BOS-27 is merged.
Author
Owner

BOS-27 acceptance is now recorded as passed and its issue is in REVIEW, but PR #56 is not yet in origin/main (currently BOS main is 5ae8040; BOS-27 branch is 44504c0). Since this settings copy describes behavior BOS does not ship until PR #56 lands, BSET-20 remains TODO pending that merge. PR #22 still contains the completed copy change and no CI issue was recorded.

BOS-27 acceptance is now recorded as passed and its issue is in REVIEW, but PR #56 is not yet in `origin/main` (currently BOS `main` is 5ae8040; BOS-27 branch is 44504c0). Since this settings copy describes behavior BOS does not ship until PR #56 lands, BSET-20 remains TODO pending that merge. PR #22 still contains the completed copy change and no CI issue was recorded.
Author
Owner

The implementation in PR #22 is complete, previously independently reviewed, and its check / check (push) is green. BOS-27's acceptance is recorded as passed and that issue is in REVIEW, but BOS PR #56 is not yet in origin/main. I am moving BSET-20 to REVIEW to keep the completed settings change visible there; do not merge until PR #56 lands and the copy is verified against main.

The implementation in PR #22 is complete, previously independently reviewed, and its `check / check (push)` is green. BOS-27's acceptance is recorded as passed and that issue is in REVIEW, but BOS PR #56 is not yet in `origin/main`. I am moving BSET-20 to REVIEW to keep the completed settings change visible there; do not merge until PR #56 lands and the copy is verified against main.
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
Breadway/bos-settings#21
No description provided.