NAME

       guix - manual page for guix environment (GNU Guix) 1.4.0rc1

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.

       -l, --load=FILE
              create environment for the package that the code within FILE evaluates to

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

       -e, --expression=EXPR
              create environment for the package that EXPR evaluates to

       -m, --manifest=FILE
              create environment with the manifest from FILE

       -p, --profile=PATH
              create environment from profile at PATH

       --check
              check if the shell clobbers environment variables

       --pure unset existing environment variables

       -E, --preserve=REGEXP
              preserve environment variables that match REGEXP

       --search-paths
              display needed environment variable definitions

       -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

       -S, --symlink=SPEC
              for   containers,   add   symlinks   to   the   profile  according  to  SPEC,  e.g.
              "/usr/bin/env=bin/env".

       -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

       --list-systems
              list available systems

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

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

SEE ALSO

       The full documentation for guix is maintained as a Texinfo manual.  If the info  and  guix
       programs are properly installed at your site, the command

              info guix

       should give you access to the complete manual.