Home Explore Blog Models 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
51a54758 (1st chunk of `nixos/doc/manual/installation/installing-behind-a-proxy.section.md`)
Title: Installing NixOS Behind a Proxy
Summary
This document outlines the steps for installing NixOS behind a proxy. Before running `nixos-install`, users must first update the `/mnt/etc/nixos/configuration.nix` file with the proxy URL and `noProxy` settings to maintain internet access after reboot. Additionally, proxy environment variables (`http_proxy`, `HTTP_PROXY`, `https_proxy`, `HTTPS_PROXY`) need to be set in the shell session where `nixos-install` will be executed. A note also suggests using the `specialisation` option for managing different proxy configurations across various networks.