commit 70f21a213651a0f4149bea10721fea04485c8a80 · pyrox.dev/nixpkgs

+8 -8
doc/packages/darwin-builder.section.md
···

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

     

       2
       2
        
       

     

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

     

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

     

       4
       4
        
       

     

       5
       5
        
       This requires macOS version 12.4 or later.

     

       6
       6
        
       

     

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

     

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

     

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

     

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

     

       10
       10
        
       

     
···

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

     

       16
       16
        
       ```

     

       17
       17
        
       

     

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

     

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

     

       19
       19
        
       

     

       20
       20
        
       ```ShellSession

     

       21
       21
        
       $ nix run nixpkgs#darwin.linux-builder

     
···

       57
       57
        
       builders-use-substitutes = true

     

       58
       58
        
       ```

     

       59
       59
        
       

     

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

     

       60
       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
       61
        
       

     

       62
       62
        
       ```

     

       63
       63
        
       Host linux-builder

     
···

       130
       130
        
       }

     

       131
       131
        
       ```

     

       132
       132
        
       

     

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

     

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

     

       134
       134
        
       

     

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

     

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

     

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

     

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

     

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

     

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

     

       138
       138
        
       

     

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

     

       140
       140
        
       in the example below and rebuild.