GUIX(1)

📦
version 1.5.0 · 4 versions
, in alpine 3.24

🎀 GUIX(1) — the glow-up edition 🎀

ok so this is the manual page for guix, version 1.5.0rc1.47-fc2f5a. It lives in the User Commands section of the manual, bestie. Come sit with me, I'll walk you through it 💖

✨ SYNOPSIS ✨

guix OPTION | COMMAND ARGS...

💅 DESCRIPTION 💅

Literally the whole vibe: run COMMAND with ARGS, if the args are given. That's it, that's the deal 🫶

Here are the two options that work at this level:

  • -h, --help — shows you this helpful text again and then dips out. iconic.
  • -V, --version — prints the version plus the copyright info, then exits. slay.
COMMAND has to be one of the sub-commands listed below. no random stuff, bestie — it's a whole menu 👑

🌸 main commands 🌸

  • deploy — deploy operating systems on a set of machines
  • describe — describe the channel revisions currently used
  • gc — invoke the garbage collector
  • home — build and deploy home environments
  • install — install packages
  • locate — search for packages providing a given file
  • package — manage packages and profiles
  • pull — pull the latest revision of Guix
  • remove — remove installed packages
  • search — search for packages
  • show — show information about packages
  • system — build and deploy full operating systems
  • time-machine — run commands from a different revision
  • upgrade — upgrade packages to their latest version
  • weather — report on the availability of pre-built package binaries

🦋 software development commands 🦋

  • container — run code in containers created by guix environment -C
  • environment — spawn one-off software environments (deprecated 👀)
  • pack — create application bundles
  • shell — spawn one-off software environments

🍓 packaging commands 🍓

  • build — build packages or derivations without installing them
  • challenge — challenge substitute servers, comparing their binaries
  • download — download a file to the store and print its hash
  • edit — view and edit package definitions
  • graph — view and query package dependency graphs
  • hash — compute the cryptographic hash of a file
  • import — import a package definition from an external repository
  • lint — validate package definitions
  • publish — publish build results over HTTP
  • refresh — update existing package definitions
  • size — profile the on-disk size of packages
  • style — update the style of package definitions

🧚 plumbing commands 🧚

  • archive — manipulate, export, and import normalized archives (nars)
  • copy — copy store items remotely over SSH
  • git — operate on Git repositories
  • offload — set up and operate build offloading
  • processes — list currently running sessions
  • repl — read-eval-print loop (REPL) for interactive programming

😭 REPORTING BUGS 😭

found a bug? spill it here, don't be shy:

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. (like, fr fr, no warranty 💀)

🌈 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, then this command

info guix

should give you access to the complete manual. iykyk ✨

and that's the whole page, bestie 🎀 this one's brought to you by GNU, dated January 2026, filed under GUIX(1) — go forth and guix responsibly 💜🫶

📦 where this page comes from