Update instructions for Nix remote builder connection

Clarify instructions for connecting to the default remote builder and add information on SSH access.
This commit is contained in:
Aryeh Hillman
2025-10-30 15:54:32 -07:00
committed by GitHub
parent a5e47a4bea
commit 84a11ebe42

View File

@@ -64,13 +64,15 @@ builders = ssh-ng://builder@linux-builder ${ARCH}-linux /etc/nix/builder_ed25519
builders-use-substitutes = true builders-use-substitutes = true
``` ```
To allow Nix to connect to a remote builder not running on port 22, you will also need to create a new file at `/etc/ssh/ssh_config.d/100-linux-builder.conf`: To allow Nix to connect to the default remote builder, which does not run on port 22, you will also need to create a new file at `/etc/ssh/ssh_config.d/100-linux-builder.conf`:
``` ```
Host linux-builder Host linux-builder
Hostname localhost Hostname localhost
HostKeyAlias linux-builder HostKeyAlias linux-builder
Port 31022 Port 31022
User builder
IdentityFile /etc/nix/builder_ed25519
``` ```
… and then restart your Nix daemon to apply the change: … and then restart your Nix daemon to apply the change:
@@ -79,6 +81,8 @@ Host linux-builder
$ sudo launchctl kickstart -k system/org.nixos.nix-daemon $ sudo launchctl kickstart -k system/org.nixos.nix-daemon
``` ```
Note that if the builder is running and you have created the above ssh conf file, you can ssh into the builder with `sudo ssh builder@linux-builder`.
## Example flake usage {#sec-darwin-builder-example-flake} ## Example flake usage {#sec-darwin-builder-example-flake}
```nix ```nix