Convenient utility for distributed Nix builds
Switch branches/tags
Nothing to show
Clone or download


This is a command-line utility that you can use to run a subcommand with distributed builds transiently enabled:

$ nix-delegate --help
Usage: nix-delegate --host ARG ([--x86_64-linux] | [--x86_64-darwin])
                    [--key ARG] [--cores ARG] [--feature ARG] COMMAND [ARGS]
  Run a subcommand with distributed builds transiently enabled

Available options:
  --host ARG               Machine to use as a build slave
  --key ARG                Path to SSH private key (Default: ~/.ssh/id_rsa)
  --cores ARG              Number of cores to use (Default: 1)
  --feature ARG            Supported system features
  COMMAND                  Command to delegate (if 'nix-build', sudo will be
                           used if $NIX_REMOTE=daemon)
  -h,--help                Show this help text

The first positional argument is the command to run with distributed builds transiently enabled (in this example, nix-build). All options, flags, or arguments immediately following the first positional argument are collected and fed to the command.


$ nix-delegate --host parnell@jenkins-slave-nixos01 --cores 4 --x86_64-linux --key /home/parnell/.ssh/awake nix-build --no-out-link -A shipit release.nix
[+] Downloading: /etc/nix/signing-key.sec
[+] Installing: /etc/nix/signing-key.sec
[+] Downloading: /etc/nix/
[+] Installing: /etc/nix/
[+] Running command: sudo nix-build --no-out-link -A shipit release.nix
[+] Full command context: sudo NIX_BUILD_HOOK=/nix/store/jj3kq2dmllvkqwwbhnmzbk9hfgncdbvl-nix-1.11.6/libexec/nix/

If you are on a system with the nix-daemon running and you are not root, this utility will detect if your nix-build work is handled by the nix-daemon and if nix-build is supplied in the first positional argument then sudo will be automatically prepended to the command.

Any other commands supplied are not auto-prefixed with sudo.