Scroll to navigation

GUIX(1) User Commands GUIX(1)

NAME

guix - manual page for guix system (GNU Guix) 1.3.0.27848-a3264

SYNOPSIS

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

DESCRIPTION

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
edit the definition of an existing service type
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 image build a Guix System image 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 'image', produce an image of TYPE
for 'image', produce an image of SIZE
for 'init', do not install a bootloader
for 'image', make the root file system volatile
for 'vm', make the root file system persistent
for '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', '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
for 'vm', use the tty that we are started in for IO
skip file system and initrd module safety checks
cross-build for TRIPLET--e.g., "armel-linux-gnu"
use the given verbosity LEVEL
use BACKEND for 'extension-graph' and 'shepherd-graph'
for 'describe' and 'list-generations', list installed packages matching REGEXP
list available targets
cross-build for TRIPLET--e.g., "aarch64-linux-gnu"
list available systems
attempt to build for SYSTEM--e.g., "i686-linux"
display this help and exit
display version information and exit

REPORTING BUGS

Report bugs to: bug-guix@gnu.org.
GNU Guix home page: <https://www.gnu.org/software/guix/>
General help using Guix and GNU software: <https://guix.gnu.org/en/help/>

COPYRIGHT

Copyright © 2022 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.

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.

November 2022 GNU