table of contents
GUIX(SYSTEM) | 1 | GUIX(SYSTEM) |
NAME¶
guix system (GNU Guix) - manual page for guix system (GNU Guix) 1.2.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
- 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 vm-image build a freestanding virtual machine image disk-image build a disk image, suitable for a USB stick 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 'disk-image', produce an image of TYPE
- --image-size=SIZE
- for 'vm-image', produce an image of SIZE
- --no-bootloader
- for 'init', do not install a bootloader
- --label=LABEL
- for 'disk-image', label disk image with LABEL
- --save-provenance
- save provenance information
- 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', 'vm-image', 'disk-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
- -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/help/>
COPYRIGHT¶
Copyright © 2020 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.
(GNU | GUIX) |