RESTIC-PRUNE(1)

💅 restic-prune(1) — the glow-up edition

okay bestie, so this is a page from the restic backup manual, and today's main character is restic-prune 🎀

---

✨ NAME ✨

restic-prune — Remove unneeded data from the repository 🧹🦋

---

🌸 SYNOPSIS 🌸

restic prune [flags]

---

💖 DESCRIPTION 💖

The "prune" command checks the repository and removes data that is not referenced and therefore not needed any more. it's giving "spring cleaning but make it a garbage collector" ✨🗑️

---

🔥 EXIT STATUS 🔥

the vibe check results, fr fr:

• Exit status is 0 if the command was successful 👑
• Exit status is 1 if there was any error 😭
• Exit status is 10 if the repository does not exist 💀
• Exit status is 11 if the repository is already locked 🔒
• Exit status is 12 if the password is incorrect 🙈

---

🎀 OPTIONS 🎀

• -n, --dry-run[=false] — do not modify the repository, just print what would be done 👀 (window shopping, no spending)
• -h, --help[=false] — help for prune 🫶
• --max-repack-size="" — stop after repacking this much data in total (allowed suffixes for size: k/K, m/M, g/G, t/T) 🧺
• --max-unused="5%" — tolerate given limit of unused data (absolute value in bytes with suffixes k/K, m/M, g/G, t/T, a value in % or the word 'unlimited') 🌈
• --repack-cacheable-only[=false] — only repack packs which are cacheable ✨
• --repack-smaller-than="" — pack below-limit packfiles (allowed suffixes: m/M) 🍓
• --repack-uncompressed[=false] — repack all uncompressed data 💜
• --unsafe-recover-no-free-space="" — UNSAFE, READ THE DOCUMENTATION BEFORE USING! Try to recover a repository stuck with no free space. Do not use without trying out 'prune --max-repack-size 0' first. 🚨

bestie. i am holding your hand when i say this: that last one literally says UNSAFE in all caps, and it tells you to read the docs and to try 'prune --max-repack-size 0' first. do not freestyle it. 💀

---

🦋 OPTIONS INHERITED FROM PARENT COMMANDS 🦋

• --cacert=[] — file to load root certificates from (default: use system certificates or $RESTIC_CACERT) 🔐
• --cache-dir="" — set the cache directory. (default: use system default cache directory) 📁
• --cleanup-cache[=false] — auto remove old cache directories 🧼
• --compression=auto — compression mode (only available for repository format version 2), one of (auto|off|fastest|better|max) (default: $RESTIC_COMPRESSION) 🗜️
• --http-user-agent="" — set a http user agent for outgoing http requests 🌐
• --insecure-no-password[=false] — use an empty password for the repository, must be passed to every restic command (insecure) 🫣
• --insecure-tls[=false] — skip TLS certificate verification when connecting to the repository (insecure) 😬
• --json[=false] — set output mode to JSON for commands that support it 📜
• --key-hint="" — key ID of key to try decrypting first (default: $RESTIC_KEY_HINT) 🔑
• --limit-download=0 — limits downloads to a maximum rate in KiB/s. (default: unlimited) ⬇️
• --limit-upload=0 — limits uploads to a maximum rate in KiB/s. (default: unlimited) ⬆️
• --no-cache[=false] — do not use a local cache 🚫
• --no-extra-verify[=false] — skip additional verification of data before upload (see documentation) 🙈
• --no-lock[=false] — do not lock the repository, this allows some operations on read-only repositories 🔓
• -o, --option=[] — set extended option (key=value, can be specified multiple times) 🎛️
• --pack-size=0 — set target pack size in MiB, created pack files may be larger (default: $RESTIC_PACK_SIZE) 📦
• --password-command="" — shell command to obtain the repository password from (default: $RESTIC_PASSWORD_COMMAND) 🐚
• -p, --password-file="" — file to read the repository password from (default: $RESTIC_PASSWORD_FILE) 🗝️
• -q, --quiet[=false] — do not output comprehensive progress report 🤫
• -r, --repo="" — repository to backup to or restore from (default: $RESTIC_REPOSITORY) 🏠
• --repository-file="" — file to read the repository location from (default: $RESTIC_REPOSITORY_FILE) 📄
• --retry-lock=0s — retry to lock the repository if it is already locked, takes a value like 5m or 2h (default: no retries) 🔁
• --stuck-request-timeout=5m0s — duration after which to retry stuck requests ⏳
• --tls-client-cert="" — path to a file containing PEM encoded TLS client certificate and private key (default: $RESTIC_TLS_CLIENT_CERT) 🪪
• -v, --verbose[=0] — be verbose (specify multiple times or a level using `--verbose=n```, max level/times is 2) 📣

---

👑 SEE ALSO 👑

• restic(1) — go read the parent, it's iconic 🫶

---

that's the whole page, no notes, every flag accounted for 💖

this lil' page was generated by restic generate, dated Jan 2017, and it lives in the restic backup(1) manual. mwah, slay, periodt 💅✨🌸