NAME

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

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 search for existing service types

       edit   edit the definition of an existing service type

       reconfigure
              switch to a new operating system configuration

       roll-back
              switch to the previous operating system configuration

       describe
              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

       -L, --load-path=DIR
              prepend DIR to the package module search path

       -K, --keep-failed
              keep build tree of failed builds

       -k, --keep-going
              keep going when some of the derivations fail

       -n, --dry-run
              do not build the derivations

       --fallback
              fall back to building when the substituter fails

       --no-substitutes
              build instead of resorting to pre-built substitutes

       --substitute-urls=URLS
              fetch substitute from URLS if they are authorized

       --no-grafts
              do not graft packages

       --no-offload
              do not attempt to offload builds

       --max-silent-time=SECONDS
              mark the build as failed after SECONDS of silence

       --timeout=SECONDS
              mark the build as failed after SECONDS of activity

       --rounds=N
              build N times in a row to detect non-determinism

       -c, --cores=N
              allow the use of up to N CPU cores for the build

       -M, --max-jobs=N
              allow at most N build jobs

       --debug=LEVEL
              produce debugging output at LEVEL

       -d, --derivation
              return the derivation of the given system

       -e, --expression=EXPR
              consider  the  operating-system  EXPR  evaluates  to  instead of reading FILE, when
              applicable

       --allow-downgrades for 'reconfigure', allow downgrades to earlier
              channel revisions

       --on-error=STRATEGY
              apply STRATEGY (one of nothing-special, backtrace, or debug) when an  error  occurs
              while reading FILE

       --list-image-types list available image types

       -t, --image-type=TYPE
              for 'image', produce an image of TYPE

       --image-size=SIZE
              for 'image', produce an image of SIZE

       --no-bootloader
              for 'init', do not install a bootloader

       --volatile
              for 'image', make the root file system volatile

       --persistent
              for 'vm', make the root file system persistent

       --label=LABEL
              for 'image', label disk image with LABEL

       --save-provenance
              save provenance information

       --share=SPEC
              for  'vm'  and 'container', share host file system with read/write access according
              to SPEC

       --expose=SPEC
              for 'vm' and 'container', expose host file system directory as read-only  according
              to SPEC

       -N, --network
              for 'container', allow containers to access the network

       -r, --root=FILE
              for  'vm', 'image', 'container' and 'build', make FILE a symlink to the result, and
              register it as a garbage collector root

       --full-boot
              for 'vm', make a full boot sequence

       --no-graphic
              for 'vm', use the tty that we are started in for IO

       --skip-checks
              skip file system and initrd module safety checks

       --target=TRIPLET
              cross-build for TRIPLET--e.g., "armel-linux-gnu"

       -v, --verbosity=LEVEL
              use the given verbosity LEVEL

       --graph-backend=BACKEND
              use BACKEND for 'extension-graph' and 'shepherd-graph'

       -I, --list-installed[=REGEXP]
              for 'describe' and 'list-generations', list installed packages matching REGEXP

       --list-targets
              list available targets

       --target=TRIPLET
              cross-build for TRIPLET--e.g., "aarch64-linux-gnu"

       --list-systems
              list available systems

       -s, --system=SYSTEM
              attempt to build for SYSTEM--e.g., "i686-linux"

       -h, --help
              display this help and exit

       -V, --version
              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.