GUIX(1)

📦
version 1.5.0 · 4 versions
, in alpine 3.24

💅 GUIX(1) — like, the guix gc manual page, bestie

okay so real talk: this is the manual page for guix gc, part of GNU Guix, and we're on version 1.5.0rc1.47-fc2f5a. It lives in the User Commands section of the manual, and yes it's a whole mood. Sit down, grab a strawberry 🍓, and let's get into it.

✨ NAME ✨

guix — the manual page for guix gc (GNU Guix) 1.5.0rc1.47-fc2f5a. That's it, that's the name. Short, sweet, iconic. 👑

🌸 SYNOPSIS 🌸

guix gc [OPTION]... PATHS...

that's the whole vibe check: you run guix gc, you throw some [OPTION]... at it, you throw some PATHS... at it, and it does garbage-collector things. slay.

🦋 DESCRIPTION 🦋

Invoke the garbage collector. that's literally the one-line summary and honestly? it ate. This is the command that cleans up your store so your disk doesn't have a whole meltdown. no cap.

Here come the flags — and bestie, there are a lot of them, so buckle up 🎀

  • -C, --collect-garbage[=MIN] — collect at least MIN bytes of garbage. like, at minimum you're getting MIN bytes freed. you set the bar, it clears it 💅
  • -F, --free-space=FREE — attempt to reach FREE available space in the store. it's gonna try to get you to FREE free space, okay? that's the goal.
  • -d, --delete-generations[=PATTERN] — delete profile generations matching PATTERN. bye bye old generations 👋 matching that PATTERN specifically.
  • -D, --delete — attempt to delete PATHS. note the word attempt — it's trying its best, okay 😭
  • --list-roots — list the user's garbage collector roots. these are the things holding your store items hostage (affectionately).
  • --list-busy — list store items used by running processes. busy little icons, they're not going anywhere 🔥
  • --optimize — optimize the store by deduplicating identical files. same file twice? not on this watch. dedupe era 💖
  • --list-dead — list dead paths. rip to those, but they're different 💀
  • --list-live — list live paths. these ones are still with us, thriving 🌈
  • --references — list the references of PATHS. who do these paths reference? find out.
  • -R, --requisites — list the requisites of PATHS. the full requisite list, for your viewing pleasure ✨
  • --referrers — list the referrers of PATHS. the reverse direction, bestie. who's referring to these.
  • --derivers — list the derivers of PATHS. yes, derivers. it's a word. it's guix. we don't ask questions 🧚
  • --verify[=OPTS] — verify the integrity of the store. OPTS is a comma-separated combination of 'repair' and 'contents'. so like, repair, or contents, or both with a comma between — your call. integrity check era 🫶
  • --list-failures — list cached build failures. yes, guix remembers. it caches the L's 😭
  • --clear-failures — remove PATHS from the set of cached failures. forgiveness arc. clean slate 🎀
  • --vacuum-database — repack the sqlite database tracking the store using less space. tidy up that sqlite database, she deserves it 💅
  • -h, --help — display this help and exit. the classic.
  • -V, --version — display version information and exit. also the classic.

🙈 REPORTING BUGS 🙈

found a bug? don't suffer in silence, bestie — report it:

Copyright © 2025 the Guix authors. License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>

This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law. (say it with me — no warranty, fr fr, to the extent permitted by law 🔥)

⭐ SEE ALSO ⭐

The full documentation for guix is maintained as a Texinfo manual. If the info and guix programs are properly installed at your site, the command

info guix

should give you access to the complete manual. iykyk 🦋

okay that's the whole page! this beauty is from GNU, dated January 2026, and it's the GUIX(1) page — the guix gc glow-up edition. go forth and collect that garbage, bestie 💖✨🎀

📦 where this page comes from