GUIX(1)

📦
version 1.5.0 · 4 versions
, in alpine 3.24

🦋 guix(1) — the refresh glow-up, bestie

okay so this is a User Commands page from the GNU Guix manual — specifically the man page for guix refresh, version 1.5.0rc1.47-fc2f5a. and yes we're gonna walk through it together because it's actually giving "quietly powerful" and i need you to see it 💅

✨ SYNOPSIS ✨

guix refresh [OPTION]... [PACKAGE]...

🌸 DESCRIPTION 🌸

it updates your package definitions so they match the latest upstream version. that's the whole vibe. no cap. 🌈

so when you pass PACKAGE..., it only updates the packages you actually named. but if you don't give it any packages? it updates all the packages of the distribution — or, lowkey, just the subset of them you pointed at with --select. your call, bestie 💖

🎀 OPTIONS 🎀

  • -e, --expression=EXPR — consider the package that EXPR evaluates to 👀
  • -u, --update — update the source files in place. yes, for real, it edits them ✍️
  • -s, --select=SUBSET — select all the packages in SUBSET, which is one of core, non-core, or module:NAME (eg: module:guile). and plot twist: the module can also be fully specified as 'module:(gnu packages guile)' 🧚
  • -m, --manifest=FILE — select all the packages from the manifest in FILE 📋
  • --target-version=VERSION — update the package (or packages) to VERSION. and VERSION can be partially specified, like 6 or 6.4 instead of the whole 6.4.3 🎯
  • -t, --type=UPDATER,... — restrict to updates from the specified updaters (e.g., 'gnu') 💫
  • --list-updaters — list all the available updaters and dip 🚪
  • -l, --list-dependent — list the top-level dependent packages that would need to be rebuilt as a result of upgrading PACKAGE.... it's giving "consequences, babe" 💀
  • -r, --recursive — check the PACKAGE and all its inputs for upgrades 🔁
  • -T, --list-transitive — list every single package that PACKAGE depends on. the whole family tree 😭
  • --keyring=FILE — use FILE as the keyring of upstream OpenPGP keys 🔑
  • --key-server=HOST — use HOST as the OpenPGP key server 🖥️
  • --gpg=COMMAND — use COMMAND as the GnuPG 2.x command 🫡
  • --key-download=POLICY — handle missing OpenPGP keys according to POLICY, which is one of 'auto', 'always', 'never', and 'interactive'. and when you leave it unspecified, the default policy is 'auto', which automatically selects interactive or always 🎲
  • -L, --load-path=DIR — prepend DIR to the package module search path 📁
  • -h, --help — display this help and exit 🫶
  • -V, --version — display version information and exit ⭐

🙈 REPORTING BUGS 🙈

found a bug? bestie, please tell them, they want to know:

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. like, none. zero. don't come for them 💀

🔥 SEE ALSO 🔥

the full documentation for guix is maintained as a Texinfo manual. so if info and guix are properly installed at your site, this command:

info guix

should give you access to the complete manual. iykyk 🦋

ok that's the whole page, you ate that 💅 remember: the vibe is immaculate, but the flags are load-bearing. periodt. ✨

🌸 sign-off time: this was GNU, January 2026, page GUIX(1) — mwah, go refresh something 🎀

📦 where this page comes from