From 84a11ebe4220d8d575b9fd634c9b8d3f65778ced Mon Sep 17 00:00:00 2001 From: Aryeh Hillman Date: Thu, 30 Oct 2025 15:54:32 -0700 Subject: [PATCH] Update instructions for Nix remote builder connection Clarify instructions for connecting to the default remote builder and add information on SSH access. --- doc/packages/darwin-builder.section.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/doc/packages/darwin-builder.section.md b/doc/packages/darwin-builder.section.md index fb71a78d6eb3..da46e0ee8f7d 100644 --- a/doc/packages/darwin-builder.section.md +++ b/doc/packages/darwin-builder.section.md @@ -64,13 +64,15 @@ builders = ssh-ng://builder@linux-builder ${ARCH}-linux /etc/nix/builder_ed25519 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 Hostname localhost HostKeyAlias linux-builder Port 31022 + User builder + IdentityFile /etc/nix/builder_ed25519 ``` … 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 ``` +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} ```nix