···

       
1
       
 
       
# darwin.linux-builder {#sec-darwin-builder}

     

       
2
       
 
       


     

       
3
       
-
       
`darwin.linux-builder` provides a way to bootstrap a Linux builder on a macOS machine.

     

       
4
       
 
       


     

       
5
       
 
       
This requires macOS version 12.4 or later.

     

       
6
       
 
       


     

       
7
       
-
       
The builder runs on host port 31022 by default.

     

       
8
       
 
       
You can change it by overriding `virtualisation.darwin-builder.hostPort`.

     

       
9
       
 
       
See the [example](#sec-darwin-builder-example-flake).

     

       
10
       
 
       


     
···

       
15
       
 
       
extra-trusted-users = <your username goes here>

     

       
16
       
 
       
```

     

       
17
       
 
       


     

       
18
       
-
       
To launch the builder, run the following flake:

     

       
19
       
 
       


     

       
20
       
 
       
```ShellSession

     

       
21
       
 
       
$ nix run nixpkgs#darwin.linux-builder

     
···

       
57
       
 
       
builders-use-substitutes = true

     

       
58
       
 
       
```

     

       
59
       
 
       


     

       
60
       
-
       
To allow Nix to connect to a 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`:

     

       
61
       
 
       


     

       
62
       
 
       
```

     

       
63
       
 
       
Host linux-builder

     
···

       
130
       
 
       
}

     

       
131
       
 
       
```

     

       
132
       
 
       


     

       
133
       
-
       
## Reconfiguring the builder {#sec-darwin-builder-reconfiguring}

     

       
134
       
 
       


     

       
135
       
-
       
Initially you should not change the builder configuration else you will not be

     

       
136
       
-
       
able to use the binary cache. However, after you have the builder running locally

     

       
137
       
-
       
you may use it to build a modified builder with additional storage or memory.

     

       
138
       
 
       


     

       
139
       
 
       
To do this, you just need to set the `virtualisation.darwin-builder.*` parameters as

     

       
140
       
 
       
in the example below and rebuild.

     

···

       
1
       
 
       
# darwin.linux-builder {#sec-darwin-builder}

     

       
2
       
 
       


     

       
3
       
+
       
`darwin.linux-builder` provides a way to bootstrap a Linux remote builder on a macOS machine.

     

       
4
       
 
       


     

       
5
       
 
       
This requires macOS version 12.4 or later.

     

       
6
       
 
       


     

       
7
       
+
       
The remote builder runs on host port 31022 by default.

     

       
8
       
 
       
You can change it by overriding `virtualisation.darwin-builder.hostPort`.

     

       
9
       
 
       
See the [example](#sec-darwin-builder-example-flake).

     

       
10
       
 
       


     
···

       
15
       
 
       
extra-trusted-users = <your username goes here>

     

       
16
       
 
       
```

     

       
17
       
 
       


     

       
18
       
+
       
To launch the remote builder, run the following flake:

     

       
19
       
 
       


     

       
20
       
 
       
```ShellSession

     

       
21
       
 
       
$ nix run nixpkgs#darwin.linux-builder

     
···

       
57
       
 
       
builders-use-substitutes = true

     

       
58
       
 
       
```

     

       
59
       
 
       


     

       
60
       
+
       
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`:

     

       
61
       
 
       


     

       
62
       
 
       
```

     

       
63
       
 
       
Host linux-builder

     
···

       
130
       
 
       
}

     

       
131
       
 
       
```

     

       
132
       
 
       


     

       
133
       
+
       
## Reconfiguring the remote builder {#sec-darwin-builder-reconfiguring}

     

       
134
       
 
       


     

       
135
       
+
       
Initially you should not change the remote builder configuration else you will not be

     

       
136
       
+
       
able to use the binary cache. However, after you have the remote builder running locally

     

       
137
       
+
       
you may use it to build a modified remote builder with additional storage or memory.

     

       
138
       
 
       


     

       
139
       
 
       
To do this, you just need to set the `virtualisation.darwin-builder.*` parameters as

     

       
140
       
 
       
in the example below and rebuild.