2018-09-01 15:12:35 +01:00
<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>
2018-09-30 01:51:11 +01:00
<para >
2019-09-18 21:13:35 +01:00
To install NixOS behind a proxy, do the following before running <literal > nixos-install</literal> .
2018-09-30 01:51:11 +01:00
</para>
<orderedlist numeration= "arabic" >
2018-09-01 15:12:35 +01:00
<listitem >
2018-09-30 01:51:11 +01:00
<para >
2019-09-18 21:13:35 +01:00
Update proxy configuration in <literal > /mnt/etc/nixos/configuration.nix</literal> to keep the internet accessible after reboot.
2018-09-30 01:51:11 +01:00
</para>
<programlisting >
2018-09-01 15:12:35 +01:00
networking.proxy.default = " http://user:password@proxy:port/" ;
networking.proxy.noProxy = " 127.0.0.1,localhost,internal.domain" ;
</programlisting>
</listitem>
<listitem >
2018-09-30 01:51:11 +01:00
<para >
2019-09-18 21:13:35 +01:00
Setup the proxy environment variables in the shell where you are running <literal > nixos-install</literal> .
2018-09-30 01:51:11 +01:00
</para>
<programlisting >
2018-09-01 15:12:35 +01:00
# 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>
2018-09-30 01:51:11 +01:00
</orderedlist>
2018-09-01 15:12:35 +01:00
2018-09-30 01:51:11 +01:00
<note >
<para >
2019-09-18 21:13:35 +01:00
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.
2018-09-30 01:51:11 +01:00
</para>
</note>
2018-09-01 15:12:35 +01:00
</section>