Scroll to navigation



guix system (GNU Guix) - manual page for guix system (GNU Guix) 1.2.0rc2


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


Build the operating system declared in FILE according to ACTION. Some ACTIONS support additional ARGS.

The valid values for ACTION are:

search for existing service types
switch to a new operating system configuration
switch to the previous operating system configuration
describe the current system
list-generations list the system generations switch-generation switch to an existing operating system configuration delete-generations delete old system generations build build the operating system without installing anything container build a container that shares the host's store vm build a virtual machine image that shares the host's store vm-image build a freestanding virtual machine image disk-image build a disk image, suitable for a USB stick docker-image build a Docker image init initialize a root file system to run GNU extension-graph emit the service extension graph in Dot format shepherd-graph emit the graph of shepherd services in Dot format
prepend DIR to the package module search path
keep build tree of failed builds
keep going when some of the derivations fail
do not build the derivations
fall back to building when the substituter fails
build instead of resorting to pre-built substitutes
fetch substitute from URLS if they are authorized
do not graft packages
do not attempt to offload builds
mark the build as failed after SECONDS of silence
mark the build as failed after SECONDS of activity
build N times in a row to detect non-determinism
allow the use of up to N CPU cores for the build
allow at most N build jobs
produce debugging output at LEVEL
return the derivation of the given system
consider the operating-system EXPR evaluates to instead of reading FILE, when applicable
channel revisions
apply STRATEGY (one of nothing-special, backtrace, or debug) when an error occurs while reading FILE

--list-image-types list available image types

for 'disk-image', produce an image of TYPE
for 'vm-image', produce an image of SIZE
for 'init', do not install a bootloader
for 'disk-image', label disk image with LABEL
save provenance information
for 'vm' and 'container', share host file system with read/write access according to SPEC
for 'vm' and 'container', expose host file system directory as read-only according to SPEC
for 'container', allow containers to access the network
for 'vm', 'vm-image', 'disk-image', 'container', and 'build', make FILE a symlink to the result, and register it as a garbage collector root
for 'vm', make a full boot sequence
skip file system and initrd module safety checks
cross-build for TRIPLET--e.g., "armel-linux-gnu"
use the given verbosity LEVEL
display this help and exit
display version information and exit


Report bugs to:
GNU Guix home page: <>
General help using Guix and GNU software: <>


Copyright © 2020 the Guix authors License GPLv3+: GNU GPL version 3 or later <>
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.


The full documentation for guix system (GNU Guix) is maintained as a Texinfo manual. If the info and guix system (GNU Guix) programs are properly installed at your site, the command

info guix

should give you access to the complete manual.