Scroll to navigation

GUIX(1) User Commands GUIX(1)

NAME

guix - manual page for guix shell (GNU Guix) 1.3.0.27848-a3264

SYNOPSIS

guix shell [OPTION] PACKAGES... [-- COMMAND...]

DESCRIPTION

Build an environment that includes PACKAGES and execute COMMAND or an interactive shell in that environment.

include the development inputs of the next package
add to the environment the package FILE evaluates to
inhibit loading of 'guix.scm' and 'manifest.scm'
rebuild cached environment, if any
print a manifest for the given options
for containers, emulate the Filesystem Hierarchy Standard (FHS)
create environment for the package that EXPR evaluates to
create environment with the manifest from FILE
create environment from profile at PATH
check if the shell clobbers environment variables
unset existing environment variables
preserve environment variables that match REGEXP
display needed environment variable definitions
make FILE a symlink to the result, and register it as a garbage collector root
run command within an isolated container
allow containers to access the network
link environment profile to ~/.guix-profile within an isolated container
instead of copying the name and home of the current user into an isolated container, use the name USER with home directory /home/USER
do not share current working directory with an isolated container
for containers, share writable host file system according to SPEC
for containers, expose read-only host file system according to SPEC
for containers, add symlinks to the profile according to SPEC, e.g. "/usr/bin/env=bin/env".
use the given verbosity LEVEL
use bootstrap binaries to build the environment
prepend DIR to the package module search path
keep build tree of failed builds
keep going when some of the derivations fail
do not build the derivations
fall back to building when the substituter fails
build instead of resorting to pre-built substitutes
fetch substitute from URLS if they are authorized
do not graft packages
do not attempt to offload builds
mark the build as failed after SECONDS of silence
mark the build as failed after SECONDS of activity
build N times in a row to detect non-determinism
allow the use of up to N CPU cores for the build
allow at most N build jobs
produce debugging output at LEVEL
list package transformation options not shown here
display this help and exit
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.

November 2022 GNU