diff --git a/doc/manual/installation/env-variables.xml b/doc/manual/installation/env-variables.xml
index fc39cdd9d..1fd6bafee 100644
--- a/doc/manual/installation/env-variables.xml
+++ b/doc/manual/installation/env-variables.xml
@@ -21,4 +21,51 @@ in your ~/.profile (or similar), like this:
source prefix/etc/profile.d/nix.sh
-
\ No newline at end of file
+
+
+NIX_SSL_CERT_FILE
+
+If you need to specify a custom certificate bundle to account
+for an HTTPS-intercepting man in the middle proxy, you must specify
+the path to the certificate bundle in the environment variable
+NIX_SSL_CERT_FILE.
+
+
+If you don't specify a NIX_SSL_CERT_FILE
+manually, Nix will install and use its own certificate
+bundle.
+
+
+ Set the environment variable and install Nix
+
+$ export NIX_SSL_CERT_FILE=/etc/ssl/my-certificate-bundle.crt
+$ curl https://nixos.org/nix/install | sh
+
+
+ In the shell profile and rc files (for example,
+ /etc/bashrc, /etc/zshrc),
+ add the following line:
+
+export NIX_SSL_CERT_FILE=/etc/ssl/my-certificate-bundle.crt
+
+
+
+
+You must not add the export and then do the install, as
+the Nix installer will detect the presense of Nix configuration, and
+abort.
+
+
+NIX_SSL_CERT_FILE with macOS and the Nix daemon
+
+On macOS you must specify the environment variable for the Nix
+daemon service, then restart it:
+
+
+$ sudo launchctl setenv NIX_SSL_CERT_FILE /etc/ssl/my-certificate-bundle.crt
+$ sudo launchctl kickstart -k system/org.nixos.nix-daemon
+
+
+
+
+