BUPSTASH-GC(1)

💅 BUPSTASH-GC — the girlies' guide to cleaning your repo

ok so real talk — this is BUPSTASH-GC(1), from the General Commands Manual, and no cap it's the little command that frees up your disk space. bestie, let's get into it 🎀

---

✨ SYNOPSIS ✨

Run the garbage collector against a repository, removing unreferenced data and freeing disk space. that's the whole vibe, honestly.

bupstash gc [OPTIONS]

---

🧹 DESCRIPTION 🧹

okay so picture this: bupstash gc literally walks the repository contents, hunting down unreachable data chunks and removing them, potentially reclaiming disk space. she's doing her little lap around the repo, sniffing out orphan chunks like a truffle pig but make it cute 🐷✨

It is safe to run bupstash gc at any time — no dramatic timing needed, she's chill like that. But heads up: some operations (such as bupstash-put(1)) may temporarily be delayed while she's doing her thing. not forever, just a little moment 🙈

And the iconic part? The garbage collector only relies on unencrypted metadata, so it does not need access to decryption keys to operate. she literally doesn't need the keys, she doesn't want the keys, she operates on vibes and metadata alone 💅🔑❌

---

🌸 OPTIONS 🌸

• -r, --repository REPO — the repository to connect to and operate on. may be of the form ssh://$SERVER/$PATH for remote repositories if ssh access is configured. if you don't specify it, it's set to BUPSTASH_REPOSITORY. like, she'll just know 💖
• --no-progress — suppress progress indicators. (progress indicators are also suppressed when stderr is not an interactive terminal — she can tell when you're not really watching 🫶)
• -q, --quiet — be quiet, implies --no-progress. she's on mute, no commentary, just results 🔇

---

🌈 ENVIRONMENT 🌈

• BUPSTASH_REPOSITORY — the repository to connect to. may be of the form ssh://$SERVER/$PATH for remote repositories if ssh access is configured. yes, same format as -r, she's consistent 👑
• BUPSTASH_REPOSITORY_COMMAND — a command to run to connect to an instance of bupstash-serve(1). this allows more complex connections to the repository for less common use cases. for when the basic connection isn't giving what it needs to give 🦋

---

👀 SEE ALSO 👀

go read these next bestie, iykyk:

• bupstash(1)
• bupstash-repository(7)

---

✨ and that's the tea ✨ this little gem is from May 2025, source/version BUPSTASH-GC(1) from the General Commands Manual — go forth and gc, queen, your disk space is gonna eat 🔥👑💜