.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.48.5.
.TH GUIX "1" "December 2022" "GNU" "User Commands"
.SH NAME
guix \- manual page for guix system (GNU Guix) 1.4.0rc2
.SH SYNOPSIS
.B guix
\fI\,system \/\fR[\fI\,OPTION \/\fR...] \fI\,ACTION \/\fR[\fI\,ARG \/\fR...] [\fI\,FILE\/\fR]
.SH DESCRIPTION
Build the operating system declared in FILE according to ACTION.
Some ACTIONS support additional ARGS.
.PP
The valid values for ACTION are:
.TP
search
search for existing service types
.TP
edit
edit the definition of an existing service type
.TP
reconfigure
switch to a new operating system configuration
.TP
roll\-back
switch to the previous operating system configuration
.TP
describe
describe the current system
.IP
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
.TP
\fB\-L\fR, \fB\-\-load\-path\fR=\fI\,DIR\/\fR
prepend DIR to the package module search path
.TP
\fB\-K\fR, \fB\-\-keep\-failed\fR
keep build tree of failed builds
.TP
\fB\-k\fR, \fB\-\-keep\-going\fR
keep going when some of the derivations fail
.TP
\fB\-n\fR, \fB\-\-dry\-run\fR
do not build the derivations
.TP
\fB\-\-fallback\fR
fall back to building when the substituter fails
.TP
\fB\-\-no\-substitutes\fR
build instead of resorting to pre\-built substitutes
.TP
\fB\-\-substitute\-urls\fR=\fI\,URLS\/\fR
fetch substitute from URLS if they are authorized
.TP
\fB\-\-no\-grafts\fR
do not graft packages
.TP
\fB\-\-no\-offload\fR
do not attempt to offload builds
.TP
\fB\-\-max\-silent\-time\fR=\fI\,SECONDS\/\fR
mark the build as failed after SECONDS of silence
.TP
\fB\-\-timeout\fR=\fI\,SECONDS\/\fR
mark the build as failed after SECONDS of activity
.TP
\fB\-\-rounds\fR=\fI\,N\/\fR
build N times in a row to detect non\-determinism
.TP
\fB\-c\fR, \fB\-\-cores\fR=\fI\,N\/\fR
allow the use of up to N CPU cores for the build
.TP
\fB\-M\fR, \fB\-\-max\-jobs\fR=\fI\,N\/\fR
allow at most N build jobs
.TP
\fB\-\-debug\fR=\fI\,LEVEL\/\fR
produce debugging output at LEVEL
.TP
\fB\-d\fR, \fB\-\-derivation\fR
return the derivation of the given system
.TP
\fB\-e\fR, \fB\-\-expression\fR=\fI\,EXPR\/\fR
consider the operating\-system EXPR evaluates to
instead of reading FILE, when applicable
.TP
\fB\-\-allow\-downgrades\fR for 'reconfigure', allow downgrades to earlier
channel revisions
.TP
\fB\-\-on\-error\fR=\fI\,STRATEGY\/\fR
apply STRATEGY (one of nothing\-special, backtrace,
or debug) when an error occurs while reading FILE
.HP
\fB\-\-list\-image\-types\fR list available image types
.TP
\fB\-t\fR, \fB\-\-image\-type\fR=\fI\,TYPE\/\fR
for 'image', produce an image of TYPE
.TP
\fB\-\-image\-size\fR=\fI\,SIZE\/\fR
for 'image', produce an image of SIZE
.TP
\fB\-\-no\-bootloader\fR
for 'init', do not install a bootloader
.TP
\fB\-\-volatile\fR
for 'image', make the root file system volatile
.TP
\fB\-\-persistent\fR
for 'vm', make the root file system persistent
.TP
\fB\-\-label\fR=\fI\,LABEL\/\fR
for 'image', label disk image with LABEL
.TP
\fB\-\-save\-provenance\fR
save provenance information
.TP
\fB\-\-share\fR=\fI\,SPEC\/\fR
for 'vm' and 'container', share host file system with
read/write access according to SPEC
.TP
\fB\-\-expose\fR=\fI\,SPEC\/\fR
for 'vm' and 'container', expose host file system
directory as read\-only according to SPEC
.TP
\fB\-N\fR, \fB\-\-network\fR
for 'container', allow containers to access the network
.TP
\fB\-r\fR, \fB\-\-root\fR=\fI\,FILE\/\fR
for 'vm', 'image', 'container' and 'build',
make FILE a symlink to the result, and
register it as a garbage collector root
.TP
\fB\-\-full\-boot\fR
for 'vm', make a full boot sequence
.TP
\fB\-\-no\-graphic\fR
for 'vm', use the tty that we are started in for IO
.TP
\fB\-\-skip\-checks\fR
skip file system and initrd module safety checks
.TP
\fB\-\-target\fR=\fI\,TRIPLET\/\fR
cross\-build for TRIPLET\-\-e.g., "armel\-linux\-gnu"
.TP
\fB\-v\fR, \fB\-\-verbosity\fR=\fI\,LEVEL\/\fR
use the given verbosity LEVEL
.TP
\fB\-\-graph\-backend\fR=\fI\,BACKEND\/\fR
use BACKEND for 'extension\-graph' and 'shepherd\-graph'
.TP
\fB\-I\fR, \fB\-\-list\-installed\fR[=\fI\,REGEXP\/\fR]
for 'describe' and 'list\-generations', list installed
packages matching REGEXP
.TP
\fB\-\-list\-targets\fR
list available targets
.TP
\fB\-\-target\fR=\fI\,TRIPLET\/\fR
cross\-build for TRIPLET\-\-e.g., "aarch64\-linux\-gnu"
.TP
\fB\-\-list\-systems\fR
list available systems
.TP
\fB\-s\fR, \fB\-\-system\fR=\fI\,SYSTEM\/\fR
attempt to build for SYSTEM\-\-e.g., "i686\-linux"
.TP
\fB\-h\fR, \fB\-\-help\fR
display this help and exit
.TP
\fB\-V\fR, \fB\-\-version\fR
display version information and exit
.SH "REPORTING BUGS"
Report bugs to: bug\-guix@gnu.org.
.br
GNU Guix home page: <https://www.gnu.org/software/guix/>
.br
General help using Guix and GNU software: <https://guix.gnu.org/en/help/>
.SH COPYRIGHT
Copyright \(co 2022 the Guix authors
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
.br
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
.SH "SEE ALSO"
The full documentation for
.B guix
is maintained as a Texinfo manual.  If the
.B info
and
.B guix
programs are properly installed at your site, the command
.IP
.B info guix
.PP
should give you access to the complete manual.