How does devenv compare to Docker for local development?

devenv uses Nix to create reproducible environments without containers, offering faster activation and declarative configuration, but Docker is better for containerized deployment and cross-platform consistency without Nix dependency. Devenv's OCI feature bridges this but still relies on Nix internals.

Can I use devenv on Windows without WSL?

Devenv primarily supports Windows through WSL2; native Windows support is limited and experimental, as Nix itself has poor native Windows compatibility. For full functionality, WSL is recommended per the documentation.

How to add a custom package to my devenv environment?

Use the `packages` option in devenv.nix to list Nix packages from nixpkgs, or override inputs in devenv.yaml to include custom versions. For ad-hoc additions, use the --option flag from the CLI with package lists.

What's the difference between devenv and nix-shell?

Devenv builds on nix-shell with added features like a terminal UI, process manager, and service integration, making it more user-friendly for complex environments. However, it introduces its own configuration layer and caching, which may not be needed for simple nix-shell use cases.

Does devenv work with existing Nix flakes?

Yes, devenv integrates with Nix flakes via inputs in devenv.yaml, allowing you to pin and override dependencies. It can import configurations from flake references, but it adds abstraction that might require adjustments for advanced flake users.

How does devenv handle secrets securely?

Devenv uses SecretSpec for declarative secrets management, supporting providers like keyring, 1Password, and dotenv. This allows secrets to be defined in configuration but fetched dynamically, though it requires setting up the provider separately.

Open-Awesome

devenv

Apache-2.0Rustv2.1.2

A fast, declarative, and reproducible developer environment tool built on Nix for consistent project setups.

Visit Website GitHub

7.2k stars527 forks0 contributors

What is devenv?

devenv is a tool for creating fast, declarative, and reproducible developer environments using Nix. It provides a consistent setup for projects by managing languages, packages, services, and processes through a simple configuration file, eliminating environment inconsistencies across teams and machines.

Target Audience

Developers and teams working on projects that require consistent environments across different operating systems, especially those using Nix or seeking reproducible builds.

Value Proposition

Developers choose devenv for its speed, ease of use, and comprehensive feature set—offering instant environments, a built-in process manager, and seamless integration with Nixpkgs without deep Nix expertise.

Overview

Fast, Declarative, Reproducible, and Composable Developer Environments using Nix

Use Cases

Best For

Setting up reproducible development environments for team projects
Managing multiple languages and services in a single project configuration
Building and running OCI containers without Docker
Creating ad-hoc environments for quick testing or experimentation
Integrating with direnv for automatic shell activation
Managing secrets declaratively across different providers

Not Ideal For

Teams deeply invested in Docker Compose or similar container-based workflows who prefer not to introduce Nix into their toolchain.
Projects targeting native Windows development without WSL, as Nix's support on Windows is limited and experimental.
Simple, single-language applications where language-specific virtual environments or package managers are sufficient and less overhead.

Pros & Cons

Pros

Instant Environment Activation

Leverages incremental Nix evaluation caching to activate environments in under 100ms when nothing has changed, significantly speeding up developer workflow compared to traditional setups.

Comprehensive Tooling Integration

Supports over 50 languages with built-in tooling and 40+ services like PostgreSQL and Redis, reducing manual setup time for complex, multi-service projects.

Built-in Process Manager

Includes a native process manager written in Rust with dependency ordering, automatic port allocation, and readiness probes, simplifying local service management without external tools.

OCI Container Builds

Allows building containers directly from the environment without Docker, leveraging Nix's reproducibility for consistent container images, as highlighted in the container feature documentation.

Cons

Nix Dependency and Learning Curve

Requires Nix to be installed and configured, which can be a significant barrier for teams unfamiliar with Nix's concepts and ecosystem, despite devenv's simplification efforts.

Configuration File Complexity

While the Terminal UI and LSP help, the devenv.nix configuration can become intricate for large projects, and understanding Nix expressions is necessary for advanced customizations beyond basic options.

Ecosystem Lock-in

Tightly coupled with Nixpkgs; if a required package or version isn't available, integration becomes challenging and may require manual overrides or inputs management, adding complexity.

Frequently Asked Questions

Related Projects

goose

an open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM

Stars51,561

Forks5,677

Last commit7 hours ago

just

🤖 Just a command runner

Stars34,913

Forks825

Last commit12 hours ago

mise

dev tools, env vars, task runner

Stars31,057

Forks1,283

Last commit6 hours ago

A Git-compatible VCS that is both simple and powerful

Stars30,567

Forks1,146