Home Explore Blog CI



nixpkgs

nixos/doc/manual/installation/installing-behind-a-proxy.section.md
9ac654481f372d635c561b99b9bdee8f40a6f985aa8b1ce000000003000003d4
# Installing behind a proxy {#sec-installing-behind-proxy}

To install NixOS behind a proxy, do the following before running
`nixos-install`.

1.  Update proxy configuration in `/mnt/etc/nixos/configuration.nix` to
    keep the internet accessible after reboot.

    ```nix
    {
      networking.proxy.default = "http://user:password@proxy:port/";
      networking.proxy.noProxy = "127.0.0.1,localhost,internal.domain";
    }
    ```

1.  Setup the proxy environment variables in the shell where you are
    running `nixos-install`.

    ```ShellSession
    # 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"
    ```

::: {.note}
If you are switching networks with different proxy configurations, use
the `specialisation` option in `configuration.nix` to switch proxies at
runtime. Refer to [](#ch-options) for more information.
:::

Chunks
72215333 (1st chunk of `nixos/doc/manual/installation/installing-behind-a-proxy.section.md`)
Title: Installing NixOS Behind a Proxy
Summary
To install NixOS behind a proxy, you need to configure the proxy settings in `/mnt/etc/nixos/configuration.nix` and set the proxy environment variables in the shell before running `nixos-install`. The configuration.nix settings ensure internet access after reboot. Also, you can use the `specialisation` option in `configuration.nix` to switch proxies at runtime when switching networks.