{"id":20520267,"url":"https://github.com/bashclub/zfs-housekeeping","last_synced_at":"2025-06-16T15:02:53.833Z","repository":{"id":116153957,"uuid":"361273283","full_name":"bashclub/zfs-housekeeping","owner":"bashclub","description":"Originally 'zfs-keep-and-clean' - this script scans  your zpool and removes snapshots older than those you want to keep.","archived":false,"fork":false,"pushed_at":"2022-12-28T13:08:02.000Z","size":14,"stargazers_count":14,"open_issues_count":0,"forks_count":4,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-03-27T16:11:55.639Z","etag":null,"topics":["zfs","zfs-autosnapshot-rotation","zfs-backup","zfs-snapshots","zfsonlinux"],"latest_commit_sha":null,"homepage":"https://sysops.tv","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bashclub.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-04-24T21:45:41.000Z","updated_at":"2025-03-07T20:28:09.000Z","dependencies_parsed_at":null,"dependency_job_id":"c87551ac-b9d5-4eb3-8f61-5956f8e074e2","html_url":"https://github.com/bashclub/zfs-housekeeping","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bashclub%2Fzfs-housekeeping","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bashclub%2Fzfs-housekeeping/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bashclub%2Fzfs-housekeeping/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bashclub%2Fzfs-housekeeping/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bashclub","download_url":"https://codeload.github.com/bashclub/zfs-housekeeping/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248809056,"owners_count":21164896,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["zfs","zfs-autosnapshot-rotation","zfs-backup","zfs-snapshots","zfsonlinux"],"created_at":"2024-11-15T22:18:55.187Z","updated_at":"2025-04-14T02:13:32.569Z","avatar_url":"https://github.com/bashclub.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# zfs-keep-and-clean\n\n## Script cleansnaps.sh (neu)\nSnapshots nach Datasets und Muster im Snapshotnamen filtern und ggf. löschen.\nEs können alle bis auf die letzten x Snapshots behalten werden (-k keep).\nZu löschende Snapshots werden mit einem '-' gekennzeichnet.\n\n### Aufruf:\n```  \nroot@zfsrasp~# ./cleansnaps.sh -h\n\nAufruf: cleansnaps.sh [-htf] [-k keep] \u003cDatasetfilter\u003e [Snapshotfilter]\n\n        -h Hilfe Anzeigen\n        -t Testmodus. Simulation von löschen ohne Nachfragen (benötigt -k)\n        -f Echtmodus. Snapshots löschen ohne Nachfragen (benötigt -k)\n        -k \u003cAnzahl\u003e Anzahl der letzten Snapshots die behalten werden sollen.\n           Rest wird gelöscht. Ohne -t oder -f kommt Abfrage ob gelöscht werden soll.\n```\n### Beispiele:\nNur Filtern (ohne löschen):\n```\nroot@zfsrasp:~# ./cleansnaps.sh  backup frequent\n# Gefilterte Datasets:\n  NAME                USED  AVAIL     REFER  MOUNTPOINT\n  backup             3.93M  3.62G       24K  /backup\n  backup/smbshr       182K  3.62G     50.5K  /backup/smbshr\n\n# Dataset: backup\n# Snapfilter: frequent\n# Anzahl Snaps: 4\n# Liste Snaps:\n  + backup@zfs-auto-snap_frequent-2021-01-01-2030\n  + backup@zfs-auto-snap_frequent-2021-01-01-2045\n  + backup@zfs-auto-snap_frequent-2021-01-01-2100\n  + backup@zfs-auto-snap_frequent-2021-01-01-2115\n\n# Dataset: backup/smbshr\n# Snapfilter: frequent\n# Anzahl Snaps: 6\n# Liste Snaps:\n  + backup/smbshr@zfs-auto-snap_frequent-2020-12-28-1145\n  + backup/smbshr@zfs-auto-snap_frequent-2020-12-28-1200\n  + backup/smbshr@zfs-auto-snap_frequent-2021-01-01-2030\n  + backup/smbshr@zfs-auto-snap_frequent-2021-01-01-2045\n  + backup/smbshr@zfs-auto-snap_frequent-2021-01-01-2100\n  + backup/smbshr@zfs-auto-snap_frequent-2021-01-01-2115\n\nroot@zfsrasp:~#\n```\nInteraktiv - Filtern und alle außer die letzten 10 löschen:\n```\nroot@zfsrasp:~# ./cleansnaps.sh -k 10 backup$ daily\n# Gefilterte Datasets:\n  NAME                USED  AVAIL     REFER  MOUNTPOINT\n  backup             4.00M  3.62G       24K  /backup\n\n# Dataset: backup\n# Snapfilter: daily\n# Anzahl Snaps: 12\n# Behalte: 10\n# Anzahl Del. Snaps: 2\n# Liste Snaps:\n  - backup@zfs-auto-snap_daily-2020-12-21-0525\n  - backup@zfs-auto-snap_daily-2020-12-22-0525\n  + backup@zfs-auto-snap_daily-2020-12-23-0525\n  + backup@zfs-auto-snap_daily-2020-12-24-0525\n  + backup@zfs-auto-snap_daily-2020-12-25-0525\n  + backup@zfs-auto-snap_daily-2020-12-26-0525\n  + backup@zfs-auto-snap_daily-2020-12-27-0525\n  + backup@zfs-auto-snap_daily-2020-12-28-0525\n  + backup@zfs-auto-snap_daily-2020-12-29-0525\n  + backup@zfs-auto-snap_daily-2020-12-30-0525\n  + backup@zfs-auto-snap_daily-2020-12-31-0525\n  + backup@zfs-auto-snap_daily-2021-01-01-0525\n\u003e Snapshots (2 von 12) mit J löschen (Return = weiter): J\n% zfs destroy wird ausgeführt:\n  will destroy backup@zfs-auto-snap_daily-2020-12-21-0525\n  will reclaim 0B\n  will destroy backup@zfs-auto-snap_daily-2020-12-22-0525\n  will reclaim 0B\n% Liste nach zfs destroy:\n  + backup@zfs-auto-snap_daily-2020-12-23-0525\n  + backup@zfs-auto-snap_daily-2020-12-24-0525\n  + backup@zfs-auto-snap_daily-2020-12-25-0525\n  + backup@zfs-auto-snap_daily-2020-12-26-0525\n  + backup@zfs-auto-snap_daily-2020-12-27-0525\n  + backup@zfs-auto-snap_daily-2020-12-28-0525\n  + backup@zfs-auto-snap_daily-2020-12-29-0525\n  + backup@zfs-auto-snap_daily-2020-12-30-0525\n  + backup@zfs-auto-snap_daily-2020-12-31-0525\n  + backup@zfs-auto-snap_daily-2021-01-01-0525\n\nroot@zfsrasp:~#\n```\nTestmodus - löschen nur simulieren (ohne Nachfragen):\n```\nroot@zfsrasp:~# ./cleansnaps.sh -t -k 5 backup$ daily\n# Gefilterte Datasets:\n  NAME                USED  AVAIL     REFER  MOUNTPOINT\n  backup             3.98M  3.62G       24K  /backup\n\n# Dataset: backup\n# Snapfilter: daily\n# Anzahl Snaps: 10\n# Behalte: 5\n# Anzahl Del. Snaps: 5\n# Liste Snaps:\n  - backup@zfs-auto-snap_daily-2020-12-23-0525\n  - backup@zfs-auto-snap_daily-2020-12-24-0525\n  - backup@zfs-auto-snap_daily-2020-12-25-0525\n  - backup@zfs-auto-snap_daily-2020-12-26-0525\n  - backup@zfs-auto-snap_daily-2020-12-27-0525\n  + backup@zfs-auto-snap_daily-2020-12-28-0525\n  + backup@zfs-auto-snap_daily-2020-12-29-0525\n  + backup@zfs-auto-snap_daily-2020-12-30-0525\n  + backup@zfs-auto-snap_daily-2020-12-31-0525\n  + backup@zfs-auto-snap_daily-2021-01-01-0525\n# Testmodus - Für folgende Snapshots würde ein destroy ausgeführt:\n  backup@zfs-auto-snap_daily-2020-12-23-0525    creation        Wed Dec 23  6:25 2020            -\n  backup@zfs-auto-snap_daily-2020-12-24-0525    creation        Thu Dec 24  6:25 2020            -\n  backup@zfs-auto-snap_daily-2020-12-25-0525    creation        Fri Dec 25  6:25 2020            -\n  backup@zfs-auto-snap_daily-2020-12-26-0525    creation        Sat Dec 26  6:25 2020            -\n  backup@zfs-auto-snap_daily-2020-12-27-0525    creation        Sun Dec 27  6:25 2020            -\nroot@zfsrasp:~#\n```\n\nForcemodus - löschen ohne Nachfragen:\n```\nroot@zfsrasp:~# ./cleansnaps.sh -f -k 6 backup frequent\n# Gefilterte Datasets:\n  NAME                USED  AVAIL     REFER  MOUNTPOINT\n  backup             3.98M  3.62G       24K  /backup\n  backup/smbshr       182K  3.62G     50.5K  /backup/smbshr\n\n# Dataset: backup\n# Snapfilter: frequent\n# Anzahl Snaps: 4\n# Behalte: 6\n# Anzahl Del. Snaps: 0\n# Liste Snaps:\n  + backup@zfs-auto-snap_frequent-2021-01-01-2000\n  + backup@zfs-auto-snap_frequent-2021-01-01-2015\n  + backup@zfs-auto-snap_frequent-2021-01-01-2030\n  + backup@zfs-auto-snap_frequent-2021-01-01-2045\n% Keine Snapshots zum löschen\n\n# Dataset: backup/smbshr\n# Snapfilter: frequent\n# Anzahl Snaps: 8\n# Behalte: 6\n# Anzahl Del. Snaps: 2\n# Liste Snaps:\n  - backup/smbshr@zfs-auto-snap_frequent-2020-12-21-2130\n  - backup/smbshr@zfs-auto-snap_frequent-2020-12-21-2145\n  + backup/smbshr@zfs-auto-snap_frequent-2020-12-28-1145\n  + backup/smbshr@zfs-auto-snap_frequent-2020-12-28-1200\n  + backup/smbshr@zfs-auto-snap_frequent-2021-01-01-2000\n  + backup/smbshr@zfs-auto-snap_frequent-2021-01-01-2015\n  + backup/smbshr@zfs-auto-snap_frequent-2021-01-01-2030\n  + backup/smbshr@zfs-auto-snap_frequent-2021-01-01-2045\n% zfs destroy wird ausgeführt:\n  will destroy backup/smbshr@zfs-auto-snap_frequent-2020-12-21-2130\n  will reclaim 0B\n  will destroy backup/smbshr@zfs-auto-snap_frequent-2020-12-21-2145\n  will reclaim 0B\n% Liste nach zfs destroy:\n  + backup/smbshr@zfs-auto-snap_frequent-2020-12-28-1145\n  + backup/smbshr@zfs-auto-snap_frequent-2020-12-28-1200\n  + backup/smbshr@zfs-auto-snap_frequent-2021-01-01-2000\n  + backup/smbshr@zfs-auto-snap_frequent-2021-01-01-2015\n  + backup/smbshr@zfs-auto-snap_frequent-2021-01-01-2030\n  + backup/smbshr@zfs-auto-snap_frequent-2021-01-01-2045\n\nroot@zfsrasp:~#\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbashclub%2Fzfs-housekeeping","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbashclub%2Fzfs-housekeeping","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbashclub%2Fzfs-housekeeping/lists"}