devenv-container-copy(1)

📦
version 2.4.0 · 2 versions
, in nixpkgs unstable

💅 devenv-container-copy(1) — the copy-a-container-to-a-registry page 🎀

okay so bestie, quick vibe check: this is devenv-container-copy, and yes it lives in the General Commands Manual. its whole personality? copy a container to a registry. that's it, that's the girl. 🫶

✨ NAME ✨

devenv-container-copy — copy a container to a registry. iconic, no notes. 👑

🌸 SYNOPSIS 🌸

devenv container copy [--copy-args] [-r|--registry] [--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] <NAME>

like, look at all those flags. she's got range. 💅

🦋 DESCRIPTION 🦋

Copy a container to registry. literally what it says on the tin, and honestly? she ate. ✨

💖 OPTIONS 💖

  • --copy-args <COPY_ARGS> — the copy args. you pass them. that's the whole bit.
  • -r, --registry <REGISTRY> — the registry, obviously. 🎀
  • --user-config <USER_CONFIG> — use this user configuration file instead of the XDG default. yes, the XDG default. no cap.
  • <NAME> — the name. she needs a name, bestie.

🌈 INPUT OVERRIDES 🌈

here's where it gets fun, strap in 🧚

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

can be either a filesystem path (with path: prefix) or a flake input reference. that's the rule, periodt.

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. so this is a two-arg situation, don't forget the second one 🙈

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, typed. she's typed, she's specific, she's that girl. 💅

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

list types (pkgs) append to existing values by default. add a ! suffix to replace instead, so pkgs!. lowkey important.

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> — maximum number of Nix builds to run concurrently.

defaults to 1/4 of available CPU cores (minimum 1). math! 🧮

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

defaults to available cores divided by max-jobs (minimum 1). more math, she's an academic fr.

  • -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. she's letting her hair down 💜
  • --no-impure — force a hermetic environment, overriding config. strict queen.
  • --offline — disable substituters and consider all previously downloaded files up-to-date. no internet, no problem, we're thriving in airplane mode ✈️
  • --nix-option <NAME> <VALUE> — pass additional options to nix commands.

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

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 sideways, we debug 💀

🐚 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 little VIP list for your env vars 🎟️
  • -P, --profile <PROFILES> — activate one or more profiles defined in devenv.nix.

profiles allow you to define different configurations that can be merged with your base configuration. stacking fits, basically.

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 watching 👀
  • --no-reload — disable auto-reload when config files change.
  • --shell <SHELL_TYPE> — 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). speed ✨
  • --no-eval-cache — disable caching of Nix evaluation results.
  • --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. also out with the old.

🧚 SECRETSPEC OPTIONS 🧚

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

⭐ TRACING OPTIONS ⭐

  • --trace-to <TRACE_TO> — enable tracing and set output destination(s). can be repeated for multiple outputs. she's multi-talented 💅

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 format is omitted, defaults to json. tracing is disabled by default. (yes, off until you ask, she respects boundaries 🫶)

[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. she's telling you everything.
  • -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).
ok real talk bestie, remember -h gives you the summary version of help — that's literally in the page, not me guessing 💖

and that's the whole page! this beauty is from the copy section of the devenv-container-copy(1) manual, dated and versioned as shown in the footer — so like, shoutout to whoever wrote it, you dropped this 👑. go copy that container, you're gonna slay 🦋💅✨

📦 where this page comes from