feat: add prune docs

Author: Patrick M

_posts/2023-07-02-using-prune-to-manage-archives.md

@@ -0,0 +1,55 @@
+---
+layout: post
+title: "Using Prune to Manage Archives"
+date: 2023-07-02 00:00:00 -0400
+category: "Service Setup"
+tags: ["linux", "backup"]
+---
+
+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](https://github.com/BinaryPatrick/Prune) 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.
+
+## Install
+
+To install Prune you can go to the [releases page](https://github.com/BinaryPatrick/Prune/releases) and download the latest release for your environment. If you are running Linux on x64 you can also run the following commands to download and install Prune.
+
+```bash
+GITHUB_LATEST_VERSION=$(curl -L -s -H 'Accept: application/json' https://github.com/binarypatrick/prune/releases/latest | sed -e 's/.*"tag_name":"\([^"]*\)".*/\1/')
+GITHUB_FILE="prune-linux-x64.tar.gz"
+GITHUB_URL="https://github.com/BinaryPatrick/Prune/releases/download/${GITHUB_LATEST_VERSION}/${GITHUB_FILE}"
+
+curl -L -o prune-linux-x64.tar.gz $GITHUB_URL
+tar xzvf prune-linux-x64.tar.gz ./prune
+sudo install -Dm 755 prune -t /usr/local/bin
+rm prune prune-linux-x64.tar.gz
+```
+
+## 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.
+
+![prune help](../assets/img/using-prune-to-manage-archives/prune-help.png)
+
+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.
+
+```bash
+prune --path /home/patrick/test/ --keep-last 10 --dry-run --verbose
+```
+Example output:
+
+![prune example output](../assets/img/using-prune-to-manage-archives/prune-example-output.png)
+
+You can also provide more file filtering using `--prefix` and `--ext`.
+
+```bash
+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.
+
+```bash
+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!