devenv-down(1)

📦 version 2.4.0, in nixpkgs unstable

💅 devenv-down — the devenv down girlies' field guide

okay so bestie, you're looking at devenv-down(1) from the General Commands Manual and honestly? it's giving "stop everything, we're done here" energy. let's get into it 🫶

✨ NAME ✨

devenv-down — stop the running process manager and its processes, periodt. 💀

the official vibes hub: https://devenv.sh/processes/

✨ SYNOPSIS ✨

lowkey just the whole command in one breath, no cap:

devenv down [--user-config] [--from] [-o|--override-input] [-O|--option]
[-j|--max-jobs] [-u|--cores] [-s|--system] [-i|--impure] [--no-impure]
[--offline] [--nix-option] [--nix-debugger] [-c|--clean] [-P|--profile]
[--reload] [--no-reload] [--shell] [--eval-cache] [--no-eval-cache]
[--refresh-eval-cache] [--refresh-task-cache] [--secretspec-provider]
[--secretspec-profile] [--trace-to] [-v|--verbose] [-q|--quiet] [--tui]
[--no-tui] [-h|--help]

✨ DESCRIPTION ✨

Stop the running process manager and its processes. that's it, that's the whole thing. main character behaviour honestly ✨

more lore at https://devenv.sh/processes/

✨ OPTIONS ✨

🌸 the base option

  • --user-config <USER_CONFIG> — use this user configuration file instead of the XDG default. you're the one choosing your destiny now 💅

🦋 INPUT OVERRIDES

  • --from <FROM> — where devenv.nix comes from, bestie.

it can be either a filesystem path (with a path: prefix) or a flake input reference. like, either-or, pick your fighter 🎀

examples, alphabetically iconic:

--from github:cachix/devenv
--from github:cachix/devenv?dir=examples/simple
--from path:/absolute/path/to/project
--from path:./relative/path
  • -o, --override-input <NAME> <URI> — override inputs in devenv.yaml. red flags in your flake? not on our watch 🙈

examples:

--override-input nixpkgs github:NixOS/nixpkgs/nixos-unstable
--override-input nixpkgs path:/path/to/local/nixpkgs
  • -O, --option <OPTION:TYPE> <VALUE> — override configuration options with typed values. yes you must bring the type, it's not optional, it's the whole point 🔥

OPTION must include a type: <attribute>:<type>. supported types: string, int, float, bool, path, pkg, pkgs

list types (pkgs) append to existing values by default. add a ! suffix to replace instead: pkgs! — that exclamation mark is doing SO much work 💅

examples:

--option languages.rust.channel:string beta
--option services.postgres.enable:bool true
--option languages.python.version:string 3.10
--option packages:pkgs "ncdu git"       (appends to packages)
--option packages:pkgs! "ncdu git"      (replaces all packages)

🧚 NIX OPTIONS

  • -j, --max-jobs <MAX_JOBS> — max number of Nix builds running concurrently. multitasking queen energy 👑

defaults to 1/4 of available CPU cores (minimum 1). like, it's not gonna fry your laptop, don't worry.

  • -u, --cores <CORES> — number of CPU cores available to each build. sharing is caring 🫶

defaults to available cores divided by max-jobs (minimum 1).

  • -s, --system <SYSTEM> — override the target system. not like that, the machine kind 💀

defaults to the host system (e.g. aarch64-darwin, x86_64-linux).

  • -i, --impure — relax the hermeticity of the environment. living dangerously, we love to see it ✨
  • --no-impure — force a hermetic environment, overriding config. the accountability friend of --impure 😭
  • --offline — disable substituters and consider all previously downloaded files up-to-date. airplane mode but make it nix 🌈
  • --nix-option <NAME> <VALUE> — pass additional options to nix commands. little extra seasoning, no notes 🍓

these options are passed directly to Nix using the --option flag. see man nix.conf for the full list of available options.

examples:

--nix-option sandbox false
--nix-option keep-outputs true
--nix-option system x86_64-darwin
  • --nix-debugger — enter the Nix debugger on failure. when things go wrong, go full detective mode 🕵️‍♀️

🎀 SHELL OPTIONS

  • -c, --clean [<CLEAN>...] — ignore existing environment variables when entering the shell. pass a list of comma-separated environment variables to let through. so like, a VIP list, but for env vars 💅
  • -P, --profile <PROFILES> — activate one or more profiles defined in devenv.nix. honestly? obsessed.

profiles let you define different configurations that can be merged with your base configuration. it's giving outfit layering 🧚

see https://devenv.sh/profiles for more information.

examples:

--profile python-3.14
--profile backend --profile fast-startup
  • --reload — enable auto-reload when config files change (default). she's always paying attention 👀
  • --no-reload — disable auto-reload when config files change. go touch grass, config files 🌸
  • --shell <SHELL_TYPE> — which shell to use for interactive sessions (bash, zsh, fish, nu). choose your fighter ⭐

possible values:

  • bash
  • zsh
  • fish
  • nu

🦋 CACHE OPTIONS

  • --eval-cache — enable caching of Nix evaluation results (default). work smarter, not harder 💖
  • --no-eval-cache — disable caching of Nix evaluation results. we're doing everything from scratch, apparently 😭
  • --refresh-eval-cache — force a refresh of the Nix evaluation cache. out with the old ✨
  • --refresh-task-cache — force a refresh of the task cache. same energy, different cache 🔥

🌈 SECRETSPEC OPTIONS

  • --secretspec-provider <SECRETSPEC_PROVIDER> — override the secretspec provider. secrets, but make it spec 🫶
  • --secretspec-profile <SECRETSPEC_PROFILE> — override the secretspec profile. two secretspec options, both iconic, no filler 👑

💜 TRACING OPTIONS

  • --trace-to <TRACE_TO> — enable tracing and set output destination(s). can be repeated for multiple outputs. multiple destinations? we contain multitudes 💅

syntax: [format:]destination

examples:

--trace-to stderr                              # json to stderr
--trace-to pretty:stderr                       # pretty format to stderr
--trace-to json:file:/tmp/trace.json           # JSON to file
--trace-to otlp-grpc                           # OTLP gRPC to default endpoint
--trace-to otlp-grpc:http://collector:4317     # OTLP gRPC to custom endpoint

multiple outputs, because one is never enough:

--trace-to pretty:stderr --trace-to json:file:/tmp/t.json

destinations: stdout, stderr, file:<path>, http(s)://<host>:<port>. formats: json (default), pretty, full, otlp-grpc, otlp-http-protobuf, otlp-http-json

when format is omitted, defaults to json. tracing is disabled by default. (so if you see no traces, that's not a bug, that's just the default, bestie ✨)

[env: DEVENV_TRACE_TO=] (comma-separated) [env: DEVENV_TRACE_DEFAULT_TO=] (comma-separated, used only when no explicit tracing is configured; set to empty string to suppress) — yes, that last one has a whole job description 😭

⭐ GLOBAL OPTIONS

  • -v, --verbose — enable additional debug logs. she's telling you EVERYTHING 🗣️
  • -q, --quiet — silence all logs. not a word. 🤫
  • --tui <TUI> — enable the interactive terminal interface (default when interactive). pretty screens, we love her 💖

possible values:

  • true
  • false
  • --no-tui — disable the interactive terminal interface. just text, no sparkle. valid, honestly 🌸
  • -h, --help — print help (see a summary with -h). the classic, the icon, the legend 👑
reminder bestie: devenv down stops the running process manager and its processes, so don't be surprised when the processes are, in fact, stopped. that's the whole point 💀

and that's the page!! 🎀 this little beauty is the down command from devenv-down(1) — go stop some processes, you absolute icon. bye bestie, love you, mwah 💖✨

📦 where this page comes from