NAME

       guix system (GNU Guix) - manual page for guix system (GNU Guix) 1.3.0rc2.13-21fcc

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

       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

       --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

       --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-graphs' and 'shepherd-graph'

       -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   ©   2021   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 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.

GUIX)                                                 (GNU                                          GUIX(SYSTEM)