GUIX(1)

📦
version 1.5.0 · 4 versions
, in alpine 3.24

💅 GUIX(1) 💅

okay bestie, welcome to the GUIX(1) page in the User Commands section — it’s the manual page for guix environment from GNU Guix 1.5.0rc1.47-fc2f5a 💖

💖 NAME 💖

guix — the manual page for guix environment (GNU Guix) 1.5.0rc1.47-fc2f5a. This is the one that builds you an environment with PACKAGE’s dependencies and then runs COMMAND — or hands you an interactive shell — inside it. slay.

🌸 SYNOPSIS 🌸

guix environment [OPTION]... PACKAGE... [-- COMMAND...]

✨ DESCRIPTION ✨

Build an environment that includes the dependencies of PACKAGE and execute COMMAND or an interactive shell in that environment. no cap, that’s the whole vibe check.

Okay so here’s every single option, bestie — in order, no skips, no “oops I forgot one” energy:

  • -l, --load=FILE — create an environment for the package that the code within FILE evaluates to ✨
  • --ad-hoc — include all specified packages in the environment instead of only their inputs 💅
  • -e, --expression=EXPR — create an environment for the package that EXPR evaluates to 🎀
  • -m, --manifest=FILE — create the environment with the manifest from FILE 📄
  • -p, --profile=PATH — create the environment from the profile at PATH 🦋
  • --check — check if the shell clobbers environment variables 👀
  • --pure — unset existing environment variables 🧼
  • -E, --preserve=REGEXP — preserve environment variables that match REGEXP 🫶
  • --search-paths — display needed environment variable definitions 🌈
  • -r, --root=FILE — make FILE a symlink to the result, and register it as a garbage collector root 🔥
  • -C, --container — run command within an isolated container 📦
  • -N, --network — allow containers to access the network 🌐
  • -P, --link-profile — link the environment profile to ~/.guix-profile within an isolated container 🔗
  • -W, --nesting — make Guix available within the container 🪆
  • -u, --user=USER — instead of copying the name and home directory of the current user into an isolated container, use the name USER with home directory /home/USER 👑
  • --no-cwd — do not share the current working directory with an isolated container 🙈
  • --writable-root — make the container’s root file system writable ✍️
  • --share=SPEC — for containers, share writable host file system according to SPEC 🤝
  • --expose=SPEC — for containers, expose read-only host file system according to SPEC 👁️
  • -S, --symlink=SPEC — for containers, add symlinks to the profile according to SPEC, e.g. "/usr/bin/env=bin/env". 🪄
  • -v, --verbosity=LEVEL — use the given verbosity LEVEL 🗣️
  • --bootstrap — use bootstrap binaries to build the environment 🥾
  • -L, --load-path=DIR — prepend DIR to the package module search path 📚
  • -K, --keep-failed — keep the build tree of failed builds 💀
  • -k, --keep-going — keep going when some of the derivations fail 🚀
  • -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 🤫
  • --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-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 🔍
  • -h, --help — display this help and exit 🫡
  • -V, --version — display version information and exit 🏷️

😭 REPORTING BUGS 😭

Found a bug? Do not suffer in silence, bestie.

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. literally important, don’t skip that 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 bye bestie 💖 — this page was brought to you by source/version GNU, date January 2026, and title GUIX(1). mwah 🫶

📦 where this page comes from