Files And Variables
Files
devenv.nix
The only required file for specifying the developer environment.
Generated by devenv init and thoroughly documented, starting with the
basics.
devenv.local.nix
Same as devenv.nix, but not meant to be committed into the Git
repository so that developers can override some things for their local
use case.
devenv.local.yaml
Added in 1.10
Same as devenv.yaml, but not meant to be committed into the Git
repository so that developers can override some things for their local
use case.
devenv.yaml
Configuration for inputs and imports, allowing you to specify dependencies and how to compose them.
You can require a specific devenv version to make sure all developers use a compatible version:
# Enforce CLI matches the modules versionrequire_version: true
# Or use an explicit constraintrequire_version: ">=2.1"devenv.yaml
See devenv.yaml reference for details.
devenv.lock
Pinned inputs, making sure your developer environment is reproducible.
.envrc
direnv integration logic.
See direnv integration to set up your shell to
automatically activate the developer environment when you cd into it.
Environment Variables
See the environment variables reference.
Last updated Oct 08, 2026