devenv-processes-up(1)

📦
version 2.4.0 · 2 versions
, in nixpkgs unstable

🌸 NAME 🌸

devenv-processes-up — ok so the manual name is right there bestie, and the whole thing literally does one thing: start processes. That's the vibe. That's the assignment. 💅

✨ SYNOPSIS ✨

devenv processes up [-d|--detach] [-m|--mode] [--strict-ports]
[--no-strict-ports] [--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] [PROCESSES]

🦋 DESCRIPTION 🦋

Start processes.

That's it. That's the whole description. Iconic minimalism, no notes. 😭

🎀 OPTIONS 🎀

  • -d, --detach — sends your processes to the background so you can get your terminal back. girlboss move 🫶
  • -m, --mode <MODE> [default: before] — the execution mode for process tasks. heads up: this actually affects dependency resolution, so it's not just a cute label. Possible values:
    • single: run only the task you named, zero dependencies, no plus-ones. main character energy fr
    • after: run the task you named and everything that runs after it (downstream tasks)
    • before: run all the dependency tasks first, then your task (upstream tasks) — this is the default bestie
    • all: your task plus its upstream and downstream tasks. the whole friend group shows up 💀
  • --strict-ports — if a port is already taken, this errors out instead of auto-allocating the next available port. no port-sharing, we beefing 🥊
  • --no-strict-ports — turns strict port mode OFF, and it overrides strict_ports from devenv.yaml. yes it overrides your config, it said what it said
  • --user-config <USER_CONFIG> — use this user config file instead of the XDG default 🗂️
  • [PROCESSES] — name the specific process(es) you wanna start

🔥 INPUT OVERRIDES 🔥

  • --from <FROM> — where devenv.nix comes from. it can be a filesystem path (with the path: prefix) or a flake input reference. so flexible, we love range 💖

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. swapping the source like it's an outfit change 👗

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. and ngl the typing part is mandatory: your OPTION must include a type in the form <attribute>:<type>. supported types are: string, int, float, bool, path, pkg, pkgs.

list types (pkgs) append to the existing values by default — if you wanna replace instead, slap a ! suffix on it: pkgs!. periodt.

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. so it's already being polite about your fans 🌀
  • -u, --cores <CORES> — how many CPU cores each build gets. defaults to available cores divided by max-jobs, minimum 1. math. slay.
  • -s, --system <SYSTEM> — override the target system. defaults to the host system, e.g. aarch64-darwin, x86_64-linux. you can be someone else today ✨
  • -i, --impure — relax the hermeticity of the environment. letting a lil chaos in 🙈
  • --no-impure — force a hermetic environment, overriding config. back in the clean room bestie 🧼
  • --offline — disables substituters and treats every previously downloaded file as already up-to-date. airplane mode but make it Nix ✈️
  • --nix-option <NAME> <VALUE> — pass extra options through to nix commands. these go straight to Nix via the --option flag, and you can check 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 — drops you into the Nix debugger on failure. when things go wrong we investigate, detective mode 🔍

🐚 SHELL OPTIONS 🐚

  • -c, --clean [<CLEAN>...] — ignore your existing environment variables when entering the shell. pass a list of comma-separated env vars to let through — a VIP list basically 🎟️
  • -P, --profile <PROFILES> — activate one or more profiles defined in devenv.nix. profiles let you define different configs that merge with your base config. more info at https://devenv.sh/profiles 💫

Examples:

--profile python-3.14
--profile backend --profile fast-startup
  • --reload — auto-reload when config files change. this is the default, it's already doing it 🫶
  • --no-reload — no auto-reload on config changes. changes require you to actually do something about it
  • --shell <SHELL_TYPE> — which 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 behaviour, already on, no notes ⭐
  • --no-eval-cache — disable caching of Nix evaluation results. starting fresh, we respect it
  • --refresh-eval-cache — force a refresh of the Nix evaluation cache. everything brand new again 🔄
  • --refresh-task-cache — force a refresh of the task cache. same energy, different 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, so yes, more than one is valid 💅

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, so nothing happens unless you ask for it.

[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) 🫥

👑 GLOBAL OPTIONS 👑

  • -v, --verbose — enable additional debug logs. give me all the details 🔍
  • -q, --quiet — silence all logs. peace and quiet, we're meditating 🧘
  • --tui <TUI> — enable the interactive terminal interface (default when interactive). Possible values:
    • true
    • false
  • --no-tui — disable the interactive terminal interface. no fancy UI, just vibes
  • -h, --help — print help. and psst: -h alone shows you a summary, the help text literally says "see a summary with '-h'" 💖
Heads up bestie: --offline, --no-eval-cache, and --no-reload are all about turning things off that are normally on. nothing here is dangerous, but if you're confused why a thing feels stale or disconnected, check which of these you flipped. 🔥

ok that's the whole page, every single flag accounted for, no skips, no summaries, we ate 💅✨ This little cutie comes from source up and it's filed under devenv-processes-up(1) in the manual — go forth and start some processes, bestie 🦋💜

📦 where this page comes from