guix - manual page for guix shell (GNU Guix) 1.3.0.27848-a3264
guix shell [OPTION] PACKAGES... [--
COMMAND...]
Build an environment that includes PACKAGES and execute COMMAND or
an interactive shell in that environment.
- -D,
--development
- include the development inputs of the next package
- -f,
--file=FILE
- add to the environment the package FILE evaluates to
- -q
- inhibit loading of 'guix.scm' and 'manifest.scm'
- --rebuild-cache
- rebuild cached environment, if any
- --export-manifest
- print a manifest for the given options
- -F,
--emulate-fhs
- for containers, emulate the Filesystem Hierarchy Standard (FHS)
- -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
- --help-transform
- list package transformation options not shown here
- -h, --help
- display this help and exit
- -V, --version
- display version information and exit
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 © 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.
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.