---
name: "guix-environment"
section: "1"
platform: "linux"
package: "guix"
version: "1.2.0-4+deb11u2"
release: "Debian 11 (Bullseye)"
platforms: ["linux"]
url: "https://new.carta.tech/guix-environment"
---

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