GUIX(1)

πŸ’… NAME πŸ’…

guix β€” the manual page for guix time-machine (GNU Guix), and the version we're living in rn is 1.5.0rc1.47-fc2f5a. It's filed under User Commands in the big book of manpages, bestie, and honestly it's giving time traveler energy ✨


πŸ•°οΈ SYNOPSIS πŸ•°οΈ

guix time-machine [OPTION] [-- COMMAND ARGS...]

🌸 DESCRIPTION 🌸

Okay so the whole vibe here is: it runs COMMAND ARGS... but like... in an older version of Guix. Actual time travel, no DeLorean needed πŸ¦‹

And if you don't hand it a COMMAND? It just prints the path to the time-machine profile. That's it. That's the whole moment πŸ’…


✨ OPTIONS ✨

  • -C, --channels=FILE β€” deploy the channels that are defined in FILE.
  • -q, --no-channel-files β€” stops the user and system channels.scm from loading. Inhibit them, queen πŸ™ˆ
  • --url=URL β€” use the Git repo sitting at URL.
  • --commit=COMMIT β€” pin to the specified COMMIT.
  • --branch=BRANCH β€” use the tip of the specified BRANCH. freshest of the fresh 🌈
  • --disable-authentication β€” turns off channel authentication.
  • --no-check-certificate β€” do not validate the certificate of HTTPS servers. (careful bestie, that's the whole point of the certificate 😭)
  • -L, --load-path=DIR β€” prepend DIR to the package module search path.
  • -K, --keep-failed β€” keeps the build tree of failed builds. evidence preservation πŸ’€
  • -k, --keep-going β€” keeps going even when some of the derivations fail. resilience era πŸ‘‘
  • -n, --dry-run β€” does not build the derivations. just looking πŸ‘€
  • --fallback β€” falls back to building when the substituter fails.
  • --no-substitutes β€” build it yourself instead of resorting to pre-built substitutes.
  • --substitute-urls=URLS β€” fetch substitutes from URLS, but only if they're authorized.
  • --no-grafts β€” does not graft packages.
  • --no-offload β€” does not attempt to offload builds.
  • --max-silent-time=SECONDS β€” marks the build as failed after SECONDS of silence. the silent treatment is a fail, periodt 🀐
  • --timeout=SECONDS β€” marks the build as failed after SECONDS of activity.
  • --rounds=N β€” builds N times in a row to detect non-determinism. consistency check, love that for us ⭐
  • -c, --cores=N β€” allows the use of up to N CPU cores for the build.
  • -M, --max-jobs=N β€” allows at most N build jobs.
  • --debug=LEVEL β€” produces debugging output at LEVEL.
  • -h, --help β€” displays this help and exits. the classic 🫢
  • -V, --version β€” displays version information and exits.

πŸ› REPORTING BUGS πŸ›

Found a bug? Spill it here, they will listen:


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. (read that part again, bestie, no cap πŸ’€)


πŸ‘€ SEE ALSO πŸ‘€

The full documentation for guix is maintained as a Texinfo manual. So if the info and guix programs are properly installed at your site, running

info guix

should give you access to the complete manual. iykyk πŸ“–βœ¨


lowkey iconic that this is the GNU edition, dated January 2026, and you found it on page GUIX(1) β€” go forth and time-travel responsibly, babe πŸ§šπŸ’œ
πŸ“¦ where this page comes from