GUIX(1)

๐Ÿ“ฆ
version 1.5.0 ยท 3 versions
, in alpine 3.24

๐Ÿ’… GUIX(1) โ€” like, the guix home manual page bestie ๐Ÿ โœจ

okay so this is the manual page for guix home from GNU Guix, version 1.5.0rc1.47-fc2f5a, and honestly? it's giving home directory glow-up. stay with me and you'll get it, fr fr ๐Ÿซถ

โœจ SYNOPSIS โœจ

guix home [OPTION ...] ACTION [ARG ...] [FILE]

that's the whole vibe: you got your options, then you got an ACTION (the thing you actually wanna do), then maybe some ARGs, and maybe a FILE. slay. ๐Ÿ’…

๐ŸŒธ DESCRIPTION ๐ŸŒธ

So! What this does is it builds the home environment that's declared in FILE, and it does it according to whatever ACTION you picked. Some ACTIONS are extra and let you pass additional ARGS too โ€” main character energy, they get more attention. ๐Ÿ‘‘

๐ŸŽ€ the valid values for ACTION are ๐ŸŽ€

  • search โ€” search for existing service types ๐Ÿ”
  • edit โ€” edit the definition of an existing service type โœ๏ธ
  • container โ€” run the home environment configuration in a container ๐Ÿ“ฆ
  • reconfigure โ€” switch to a new home environment configuration ๐Ÿ”„
  • roll-back โ€” switch to the previous home environment configuration โช
  • describe โ€” describe the current home environment ๐Ÿ“
  • list-generations โ€” list the home environment generations ๐Ÿ—‚๏ธ
  • switch-generation โ€” switch to an existing home environment configuration ๐Ÿ”€
  • delete-generations โ€” delete old home environment generations ๐Ÿ—‘๏ธ
  • build โ€” build the home environment without installing anything (important!! no cap) ๐Ÿ—๏ธ
  • import โ€” generates a home environment definition from dotfiles ๐Ÿงš
  • extension-graph โ€” emit the service extension graph ๐Ÿ•ธ๏ธ
  • shepherd-graph โ€” emit the graph of shepherd services ๐Ÿ‘โœจ

๐Ÿ’– the options (yes, all of them, I would never skip a single one) ๐Ÿ’–

  • -L, --load-path=DIR โ€” prepend DIR to the package module search path ๐Ÿ“š
  • -K, --keep-failed โ€” keep the build tree of failed builds (for when you need to do forensics on your own mess) ๐Ÿ•ต๏ธโ€โ™€๏ธ
  • -k, --keep-going โ€” keep going even when some of the derivations fail, like a true resilient queen ๐Ÿ’ช
  • -n, --dry-run โ€” do not build the derivations, just look respectfully ๐Ÿ‘€
  • --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... but only 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 ๐Ÿ›
  • -e, --expression=EXPR โ€” consider the home-environment EXPR evaluates to instead of reading FILE, when applicable ๐Ÿงฎ
  • --allow-downgrades โ€” for 'reconfigure', allow downgrades to earlier channel revisions โฌ
  • -N, --network โ€” allow containers to access the network ๐ŸŒ
  • --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 ๐ŸชŸ
  • -v, --verbosity=LEVEL โ€” use the given verbosity LEVEL ๐Ÿ—ฃ๏ธ
  • --graph-backend=BACKEND โ€” use BACKEND for 'extension-graph' and 'shepherd-graph' ๐Ÿ“Š
  • -I, --list-installed[=REGEXP] โ€” for 'describe' or 'list-generations', list installed packages matching REGEXP ๐Ÿ“ฆ๐Ÿ”Ž
  • -h, --help โ€” display this help and exit ๐Ÿ†˜
  • -V, --version โ€” display version information and exit ๐Ÿท๏ธ

๐Ÿ˜ญ REPORTING BUGS ๐Ÿ˜ญ

found a bug? bestie, 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. ๐Ÿซถ (yes, the all-caps NO WARRANTY is staying, it's load-bearing.)

๐Ÿฆ‹ 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 ๐Ÿ“–โœจ

๊’ฐเฆŒ(หถแต” แต• แต”หถ)เป’๊’ฑ and that's the whole page!! GNU, January 2026, GUIX(1) โ€” mwah, go build your home environment, you're gonna eat ๐Ÿ’…๐Ÿ’–๐ŸŽ€
๐Ÿ“ฆ where this page comes from