guix-system1

Usage

Overview

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

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