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

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.

NAME

SYNOPSIS

DESCRIPTION

REPORTING BUGS

COPYRIGHT

SEE ALSO