devenv-processes(1)

📦
version 2.4.0 · 2 versions
, in nixpkgs unstable

💖 NAME 💖

ok so bestie, welcome to devenv-processes — the page for starting or stopping processes ✨ this is devenv-processes(1) from your General Commands Manual, and the whole vibe lives at https://devenv.sh/processes/ 🦋

🌸 SYNOPSIS 🌸

devenv processes [--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] <subcommands>

🎀 DESCRIPTION 🎀

Start or stop processes. https://devenv.sh/processes/ — that's literally it, that's the whole thing, and honestly? iconic 💅

✨ OPTIONS ✨

  • --user-config <USER_CONFIG> — use this user configuration file instead of the XDG default 🫶

🌈 INPUT OVERRIDES 🌈

  • --from <FROM> — the source for devenv.nix.

it can be either a filesystem path (with the path: prefix) or a flake input reference 🦋

Examples:

--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.

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 🔥

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

list types (pkgs) append to existing values by default. add a ! suffix to replace instead: pkgs! no cap 💅

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 at the same time.

defaults to 1/4 of your available CPU cores (minimum 1) 🍓

  • -u, --cores <CORES> — number of CPU cores each build gets.

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

  • -s, --system <SYSTEM> — override the target system.

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

  • -i, --impure — relax the hermeticity of the environment 🙈
  • --no-impure — force a hermetic environment, overriding config 🔒
  • --offline — disable substituters and treat all previously downloaded files as up-to-date.
  • --nix-option <NAME> <VALUE> — pass extra options to nix commands.

these get handed straight 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 — drop into the Nix debugger on failure 💀

💜 SHELL OPTIONS 💜

  • -c, --clean [<CLEAN>...] — ignore existing environment variables when entering the shell. pass a list of comma-separated environment variables to let through 🫶
  • -P, --profile <PROFILES> — activate one or more profiles defined in devenv.nix.

profiles let you define different configurations that get merged with your base configuration 🔥

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

Examples:

--profile python-3.14
--profile backend --profile fast-startup
  • --reload — enable auto-reload when config files change (default) ✨
  • --no-reload — disable auto-reload when config files change 🙅
  • --shell <SHELL_TYPE> — the shell to use for interactive sessions (bash, zsh, fish, nu).

Possible values:

  • bash
  • zsh
  • fish
  • nu

🎀 CACHE OPTIONS 🎀

  • --eval-cache — enable caching of Nix evaluation results (default) ⭐
  • --no-eval-cache — disable caching of Nix evaluation results 💀
  • --refresh-eval-cache — force a refresh of the Nix evaluation cache 🔄
  • --refresh-task-cache — force a refresh of the task cache 🔄

🌸 SECRETSPEC OPTIONS 🌸

  • --secretspec-provider <SECRETSPEC_PROVIDER> — override the secretspec provider 🤫
  • --secretspec-profile <SECRETSPEC_PROFILE> — override the secretspec profile 🤫

🦋 TRACING OPTIONS 🦋

  • --trace-to <TRACE_TO> — enable tracing and set the output destination(s). can be repeated for multiple outputs 👑

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:

--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 the format is omitted, it defaults to json. tracing is disabled by default 🫶

[env: DEVENV_TRACE_TO=] (comma-separated) · [env: DEVENV_TRACE_DEFAULT_TO=] (comma-separated, used only when no explicit tracing is configured; set it to an empty string to suppress) 🙈

🌈 GLOBAL OPTIONS 🌈

  • -v, --verbose — enable additional debug logs 🐛
  • -q, --quiet — silence all logs 🤐
  • --tui <TUI> — enable the interactive terminal interface (default when interactive) 💅

Possible values:

  • true
  • false
  • --no-tui — disable the interactive terminal interface 🙅
  • -h, --help — print help (see a summary with -h) 👑

👑 SUBCOMMANDS 👑

ngl bestie, that's the whole page — every flag, every default, every little env var, all of it, no skips, fr fr 💖

ok and that's a wrap on devenv-processes(1) 🎀✨ this one's from the processes source, dated devenv-processes(1) in the old-school footer (the left side just says processes, the right side says devenv-processes(1), and there's no date hiding anywhere else, so don't come for me 🙈). catch you in the group chat, bestie — go start some processes 💅💖

📦 where this page comes from