Reference

guix-environment(1)

manual page for guix environment (GNU Guix) 1.2.0rc2

NAME

guix environment (GNU Guix) - manual page for guix environment (GNU Guix) 1.2.0rc2

SYNOPSIS

guix environment [OPTION]... PACKAGE... [-- COMMAND...]

DESCRIPTION

Build an environment that includes the dependencies of PACKAGE and execute COMMAND or an interactive shell in that environment.

-e, --expression=EXPR

create environment for the package that EXPR evaluates to

-l, --load=FILE

create environment for the package that the code within FILE evaluates to

-m, --manifest=FILE

create environment with the manifest from FILE

--ad-hoc

include all specified packages in the environment instead of only their inputs

--pure

unset existing environment variables

-E, --preserve=REGEXP

preserve environment variables that match REGEXP

--search-paths

display needed environment variable definitions

-s, --system=SYSTEM

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

-r, --root=FILE

make FILE a symlink to the result, and register it as a garbage collector root

-C, --container

run command within an isolated container

-N, --network

allow containers to access the network

-P, --link-profile

link environment profile to ~/.guix-profile within an isolated container

-u, --user=USER

instead of copying the name and home of the current user into an isolated container, use the name USER with home directory /home/USER

--no-cwd

do not share current working directory with an isolated container

--share=SPEC

for containers, share writable host file system according to SPEC

--expose=SPEC

for containers, expose read-only host file system according to SPEC

-v, --verbosity=LEVEL

use the given verbosity LEVEL

--bootstrap

use bootstrap binaries to build the environment

-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

--help-transform

list package transformation options not shown here

-h, --help

display this help and exit

-V, --version

display version information and exit

REPORTING BUGS

Report bugs to: [email protected].
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 environment (GNU Guix) is maintained as a Texinfo manual. If the info and guix environment (GNU Guix) programs are properly installed at your site, the command

info guix

should give you access to the complete manual.