diff options
author | Venkateswara Rao Mandela <venkat.mandela@gmail.com> | 2018-09-01 19:42:35 +0530 |
---|---|---|
committer | xeji <36407913+xeji@users.noreply.github.com> | 2018-09-01 16:12:35 +0200 |
commit | cb1ca420092c8854592afcf1cc0245b7245358f1 (patch) | |
tree | 7a7b846bf9b1194face6890131dadd49162f9a1c /nixos/doc | |
parent | ff679f86a25dbf8c5997476a841a5a1127fa868e (diff) |
nixos/doc: add instructions for installation behind a proxy (#45854)
The instructions to install nixos behind a proxy were not clear. While one could guess that setting http_proxy variables can get the install rolling, one could end up with an installed system where the proxy settings for the nix-daemon are not configured. This commit updates the documentation with 1. steps to install behind a proxy 2. configure the global proxy settings so that nix-daemon can access internet. 3. Pointers to use nesting.clone in case one has to use different proxy settings on different networks.
Diffstat (limited to 'nixos/doc')
-rw-r--r-- | nixos/doc/manual/installation/installing-behind-a-proxy.xml | 47 | ||||
-rw-r--r-- | nixos/doc/manual/installation/installing.xml | 1 |
2 files changed, 48 insertions, 0 deletions
diff --git a/nixos/doc/manual/installation/installing-behind-a-proxy.xml b/nixos/doc/manual/installation/installing-behind-a-proxy.xml new file mode 100644 index 0000000000000..c59d073c61c73 --- /dev/null +++ b/nixos/doc/manual/installation/installing-behind-a-proxy.xml @@ -0,0 +1,47 @@ +<section xmlns="http://docbook.org/ns/docbook" + xmlns:xlink="http://www.w3.org/1999/xlink" + xmlns:xi="http://www.w3.org/2001/XInclude" + version="5.0" + xml:id="sec-installing-behind-proxy"> + <title>Installing behind a proxy</title> + +<para> + To install NixOS behind a proxy, do the following before running + <literal>nixos-install</literal>. +</para> +<orderedlist numeration="arabic"> + <listitem> + <para> + Update proxy configuration in + <literal>/mnt/etc/nixos/configuration.nix</literal> to keep the + internet accessible after reboot. + </para> + <programlisting> +networking.proxy.default = "http://user:password@proxy:port/"; +networking.proxy.noProxy = "127.0.0.1,localhost,internal.domain"; +</programlisting> + </listitem> + <listitem> + <para> + Setup the proxy environment variables in the shell where you are + running <literal>nixos-install</literal>. + </para> + <programlisting> +# proxy_url="http://user:password@proxy:port/" +# export http_proxy="$proxy_url" +# export HTTP_PROXY="$proxy_url" +# export https_proxy="$proxy_url" +# export HTTPS_PROXY="$proxy_url" +</programlisting> + </listitem> +</orderedlist> + +<note> +<para> + If you are switching networks with different proxy configurations, use the + <literal>nesting.clone</literal> option in + <literal>configuration.nix</literal> to switch proxies at runtime. + Refer to <xref linkend="ch-options" /> for more information. +</para> +</note> +</section> diff --git a/nixos/doc/manual/installation/installing.xml b/nixos/doc/manual/installation/installing.xml index 6f8e0f613b198..916384559e24b 100644 --- a/nixos/doc/manual/installation/installing.xml +++ b/nixos/doc/manual/installation/installing.xml @@ -443,4 +443,5 @@ $ nix-env -i w3m</screen> <xi:include href="installing-pxe.xml" /> <xi:include href="installing-virtualbox-guest.xml" /> <xi:include href="installing-from-other-distro.xml" /> + <xi:include href="installing-behind-a-proxy.xml" /> </chapter> |