commit 828474abfb4ccd324c1fce3da5f7b0ff454bb21e · pyrox.dev/nixpkgs

+21

nixos/doc/manual/administration/network-problems.section.md

···

       1
       +
       # Network Problems {#sec-nix-network-issues}

     

       2
       +
       

     

       3
       +
       Nix uses a so-called *binary cache* to optimise building a package from

     

       4
       +
       source into downloading it as a pre-built binary. That is, whenever a

     

       5
       +
       command like `nixos-rebuild` needs a path in the Nix store, Nix will try

     

       6
       +
       to download that path from the Internet rather than build it from

     

       7
       +
       source. The default binary cache is `https://cache.nixos.org/`. If this

     

       8
       +
       cache is unreachable, Nix operations may take a long time due to HTTP

     

       9
       +
       connection timeouts. You can disable the use of the binary cache by

     

       10
       +
       adding `--option use-binary-caches false`, e.g.

     

       11
       +
       

     

       12
       +
       ```ShellSession

     

       13
       +
       # nixos-rebuild switch --option use-binary-caches false

     

       14
       +
       ```

     

       15
       +
       

     

       16
       +
       If you have an alternative binary cache at your disposal, you can use it

     

       17
       +
       instead:

     

       18
       +
       

     

       19
       +
       ```ShellSession

     

       20
       +
       # nixos-rebuild switch --option binary-caches http://my-cache.example.org/

     

       21
       +
       ```

-27

nixos/doc/manual/administration/network-problems.xml

···

       1
       -
       <section xmlns="http://docbook.org/ns/docbook"

     

       2
       -
               xmlns:xlink="http://www.w3.org/1999/xlink"

     

       3
       -
               xmlns:xi="http://www.w3.org/2001/XInclude"

     

       4
       -
               version="5.0"

     

       5
       -
               xml:id="sec-nix-network-issues">

     

       6
       -
        <title>Network Problems</title>

     

       7
       -
       

     

       8
       -
        <para>

     

       9
       -
         Nix uses a so-called <emphasis>binary cache</emphasis> to optimise building a

     

       10
       -
         package from source into downloading it as a pre-built binary. That is,

     

       11
       -
         whenever a command like <command>nixos-rebuild</command> needs a path in the

     

       12
       -
         Nix store, Nix will try to download that path from the Internet rather than

     

       13
       -
         build it from source. The default binary cache is

     

       14
       -
         <uri>https://cache.nixos.org/</uri>. If this cache is unreachable, Nix

     

       15
       -
         operations may take a long time due to HTTP connection timeouts. You can

     

       16
       -
         disable the use of the binary cache by adding <option>--option

     

       17
       -
         use-binary-caches false</option>, e.g.

     

       18
       -
       <screen>

     

       19
       -
       <prompt># </prompt>nixos-rebuild switch --option use-binary-caches false

     

       20
       -
       </screen>

     

       21
       -
         If you have an alternative binary cache at your disposal, you can use it

     

       22
       -
         instead:

     

       23
       -
       <screen>

     

       24
       -
       <prompt># </prompt>nixos-rebuild switch --option binary-caches <replaceable>http://my-cache.example.org/</replaceable>

     

       25
       -
       </screen>

     

       26
       -
        </para>

     

       27
       -
       </section>

+1 -1

nixos/doc/manual/administration/troubleshooting.xml

···

       12
        
        <xi:include href="../from_md/administration/maintenance-mode.section.xml" />

     

       13
        
        <xi:include href="../from_md/administration/rollback.section.xml" />

     

       14
        
        <xi:include href="../from_md/administration/store-corruption.section.xml" />

     

       15
       -
        <xi:include href="network-problems.xml" />

     

       16
        
       </chapter>

···

       12
        
        <xi:include href="../from_md/administration/maintenance-mode.section.xml" />

     

       13
        
        <xi:include href="../from_md/administration/rollback.section.xml" />

     

       14
        
        <xi:include href="../from_md/administration/store-corruption.section.xml" />

     

       15
       +
        <xi:include href="../from_md/administration/network-problems.section.xml" />

     

       16
        
       </chapter>

+25

nixos/doc/manual/from_md/administration/network-problems.section.xml

···

       1
       +
       <section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="sec-nix-network-issues">

     

       2
       +
         <title>Network Problems</title>

     

       3
       +
         <para>

     

       4
       +
           Nix uses a so-called <emphasis>binary cache</emphasis> to optimise

     

       5
       +
           building a package from source into downloading it as a pre-built

     

       6
       +
           binary. That is, whenever a command like

     

       7
       +
           <literal>nixos-rebuild</literal> needs a path in the Nix store, Nix

     

       8
       +
           will try to download that path from the Internet rather than build

     

       9
       +
           it from source. The default binary cache is

     

       10
       +
           <literal>https://cache.nixos.org/</literal>. If this cache is

     

       11
       +
           unreachable, Nix operations may take a long time due to HTTP

     

       12
       +
           connection timeouts. You can disable the use of the binary cache by

     

       13
       +
           adding <literal>--option use-binary-caches false</literal>, e.g.

     

       14
       +
         </para>

     

       15
       +
         <programlisting>

     

       16
       +
       # nixos-rebuild switch --option use-binary-caches false

     

       17
       +
       </programlisting>

     

       18
       +
         <para>

     

       19
       +
           If you have an alternative binary cache at your disposal, you can

     

       20
       +
           use it instead:

     

       21
       +
         </para>

     

       22
       +
         <programlisting>

     

       23
       +
       # nixos-rebuild switch --option binary-caches http://my-cache.example.org/

     

       24
       +
       </programlisting>

     

       25
       +
       </section>