GUIX(1)

📦
version 1.5.0 · 4 versions
, in alpine 3.24

🌸 GUIX(1) — the guix archive glow-up 🌸

Okay bestie, so this is the manual page for guix archive from GNU Guix version 1.5.0rc1.47-fc2f5a. Yes that version string is giving "I was built from a git checkout at 2am" energy and honestly? Iconic. Let's get into it 💅

✨ NAME ✨

guix — the manual page for guix archive (GNU Guix) 1.5.0rc1.47-fc2f5a

🦋 SYNOPSIS 🦋

guix archive [OPTION]... PACKAGE...

That's it, that's the whole vibe check: some options, then some packages. Periodt.

💖 DESCRIPTION 💖

Okay so the whole point of this bad boy: export/import one or more packages from/to the store. That's the main character job description right there — you're shuffling packages in and out of the Guix store like it's a group chat and you're the one forwarding the memes 🫶

Now let's meet the cast, because there are a lot of them and they all matter:

🎀 the actual options 🎀

  • --export — export the specified files/packages to stdout
  • -r, --recursive — combined with --export, include dependencies (so like, bring your whole friend group to the party)
  • --import — import from the archive passed on stdin
  • --missing — print the files from stdin that are missing
  • -x, --extract=DIR — extract the archive on stdin to DIR
  • -t, --list — list the files in the archive on stdin
  • --generate-key[=PARAMETERS] — generate a key pair with the given parameters
  • --authorize — authorize imports signed by the public key on stdin
  • -e, --expression=EXPR — build the package or derivation EXPR evaluates to
  • -S, --source — build the packages' source derivations
  • -v, --verbosity=LEVEL — use the given verbosity LEVEL
  • -L, --load-path=DIR — prepend DIR to the package module search path
  • -K, --keep-failed — keep build tree of failed builds
  • -k, --keep-going — keep going when some of the derivations fail (never abandon the group chat mid-crisis)
  • -n, --dry-run — do not build the derivations
  • --fallback — fall back to building when the substituter fails
  • --no-substitutes — build instead of resorting to pre-built substitutes
  • --substitute-urls=URLS — fetch substitute 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 (ngl relatable, I too get anxious when a build goes quiet 😭)
  • --timeout=SECONDS — mark the build as failed after SECONDS of activity
  • --rounds=N — build N times in a row to detect non-determinism
  • -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"
  • -h, --help — display this help and exit
  • -V, --version — display version information and exit
Heads up bestie: keep an eye on which of these take a value and which are just vibes-only flags. --generate-key is the fancy one with the optional [=PARAMETERS] bracket situation — that's optional-argument energy, iykyk 💅

🙈 REPORTING BUGS 🙈

Found a bug? Do not suffer in silence, the Guix devs literally want to hear about 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. No cap, that's the literal wording — read it and respect it 🫡

🌈 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. Slay, go read the whole thing, it's giving encyclopaedia but in a good way 📚✨

okay that's the whole page, you made it to the end, I'm so proud of you 🥹💜

Cute little sign-off: this beauty is from GNU, dated January 2026, and it's the GUIX(1) page. Go export something, bestie. 🎀🦋💖

📦 where this page comes from