Originally posted to binarypatrick.dev
Often times when using a tool like rsync to make backups you end up with lots of archives, and no way to keep them managed over time without a manual process. Prune is a simple tool that lets you remove prune archives in a folder, deleting any archives not matching the specified retention options. Any file type can be an archive and prune allows you to specify which files are in scope to be pruned.
https://github.com/BinaryPatrick/Prune
Install
To install Prune you can go to the releases page and download the latest release for your environment. You can also just clone the repo and compile it yourself with the steps in the readme. If you are running Linux on x64 you can also run the following commands to download and install Prune.
Don't just take my word for it. Always inspect the code that will be running on your machines, especially from an untrusted and unsigned source.
curl -s -o prune-install-linux-x64.sh https://raw.githubusercontent.com/BinaryPatrick/Prune/main/scripts/install-linux-x64.sh
chmod +x prune-install-linux-x64.sh
sudo ./prune-install-linux-x64.sh
rm prune-install-linux-x64.sh
Usage
Once it's installed, you should be able to run prune simply by typing in prune
, but don't. Prune is designed to delete things, and you should always run it with --dry-run
and --verbose
until you're certain what will be pruned.
To use prune, you will need to provide a pruning path and some retention value. Keep in mind prune is not recursive, so it will only purge files directly in the path you give. Prune also uses last modified date, not created date to evaluate what files to keep and prune. This allows for incremental backups with updates to be properly evaluated. You must specify some level of retention for prune to run.
prune --path /home/patrick/test/ --keep-last 10 --dry-run --verbose
Example output:
You can also provide more file filtering using --prefix
and --ext
.
prune --path /home/patrick/test/ --keep-last 10 --prefix backup_ --ext tar.gz --dry-run --verbose
Finally you can scope in the exact retention you want using the different retention interval filters.
prune --path /home/patrick/test/ --keep-daily 7 --keep-weekly 2 --dry-run --verbose
So far I have tested this with Debian 12 and Raspbian and it runs great.
Happy pruning!
Top comments (0)