GUIX(1)

📦
version 1.5.0 · 3 versions
, in alpine 3.24

✨ NAME ✨

okay so this is guix — literally the manual page for guix pack, part of GNU Guix (specifically version 1.5.0rc1.47-fc2f5a, so like, a very specific build bestie 💅). Yes the man page is filed under GUIX(1) and yes the name line says guix — icon behavior honestly.

✨ SYNOPSIS ✨

guix pack [OPTION]... PACKAGE...

✨ DESCRIPTION ✨

So what does it do? It creates a bundle of PACKAGE. That's the whole vibe. 🎀 And here's every single flag you can throw at it, no gatekeeping, no skips, all 40-ish of them, in order, periodt:

  • -L, --load-path=DIR — prepend DIR to the package module search path
  • -K, --keep-failed — keep the build tree of failed builds (so you can go look at the crime scene 🔍)
  • -k, --keep-going — keep going even when some of the derivations fail
  • -n, --dry-run — do not build the derivations, just look at them
  • --fallback — fall back to building when the substituter fails
  • --no-substitutes — build instead of resorting to pre-built substitutes
  • --substitute-urls=URLS — fetch substitutes from URLS if they are authorized
  • --no-grafts — do not graft packages
  • --no-offload — do not attempt to offload builds
  • --max-silent-time=SECONDS — mark the build as failed after SECONDS of silence 🤫
  • --timeout=SECONDS — mark the build as failed after SECONDS of activity
  • --rounds=N — build N times in a row to detect non-determinism (yes, literally on purpose, again and again)
  • -c, --cores=N — allow the use of up to N CPU cores for the build
  • -M, --max-jobs=N — allow at most N build jobs
  • --debug=LEVEL — produce debugging output at LEVEL
  • --list-targets — list available targets
  • --target=TRIPLET — cross-build for TRIPLET — e.g., "aarch64-linux-gnu"
  • --list-systems — list available systems
  • -s, --system=SYSTEM — attempt to build for SYSTEM — e.g., "i686-linux"
  • --help-transform — list package transformation options not shown here
  • --help-docker-format — list options specific to the docker format
  • --help-deb-format — list options specific to the deb format
  • --help-rpm-format — list options specific to the RPM format
  • --file=FORMAT — build a pack the code within FILE evaluates to
  • -f, --format=FORMAT — build a pack in the given FORMAT
  • --list-formats — list the formats available
  • -R, --relocatable — produce relocatable executables
  • -e, --expression=EXPR — consider the package EXPR evaluates to
  • -C, --compression=TOOL — compress using TOOL — e.g., "lzip"
  • -S, --symlink=SPEC — create symlinks to the profile according to SPEC
  • -m, --manifest=FILE — create a pack with the manifest from FILE
  • --entry-point=PROGRAM — use PROGRAM as the entry point of the pack
  • --save-provenance — save provenance information
  • --localstatedir — include /var/guix in the resulting pack
  • --profile-name=NAME — populate /var/guix/profiles/.../NAME
  • -r, --root=FILE — make FILE a symlink to the result, and register it as a garbage collector root ♻️
  • -d, --derivation — return the derivation of the pack
  • -v, --verbosity=LEVEL — use the given verbosity LEVEL
  • --bootstrap — use the bootstrap binaries to build the pack
  • -h, --help — display this help and exit
  • -V, --version — display version information and exit

🐛 REPORTING BUGS 🐛

Found a bug? bestie pls tell the maintainers, not me:

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. (fr fr, they mean the no-warranty part 💀)

🌈 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, you ate that ✨ — this little transmission came from GNU, stamped January 2026, and yes the man page itself is filed as GUIX(1). go build something cute 🫶💖

📦 where this page comes from