diff --git a/doc/manual/installation/env-variables.xml b/doc/manual/installation/env-variables.xml
index 91ecd114f..d1ee0bb2e 100644
--- a/doc/manual/installation/env-variables.xml
+++ b/doc/manual/installation/env-variables.xml
@@ -39,7 +39,7 @@ 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
+$ sh <(curl https://nixos.org/nix/install)
In the shell profile and rc files (for example,
diff --git a/doc/manual/installation/installing-binary.xml b/doc/manual/installation/installing-binary.xml
index 7e8dfb0db..394d8053b 100644
--- a/doc/manual/installation/installing-binary.xml
+++ b/doc/manual/installation/installing-binary.xml
@@ -6,13 +6,30 @@
Installing a Binary Distribution
-If you are using Linux or macOS, the easiest way to install
-Nix is to run the following command:
+If you are using Linux or macOS, the easiest way to install Nix
+is to run the following command:
-$ bash <(curl https://nixos.org/nix/install)
+ $ sh <(curl https://nixos.org/nix/install)
+As of Nix 2.1.0, the Nix installer will always default to creating a
+single-user installation, however opting in to the multi-user
+installation is highly recommended.
+
+
+
+ Single User Installation
+
+
+ To explicitly select a single-user installation on your system:
+
+
+ sh <(curl https://nixos.org/nix/install) --no-daemon
+
+
+
+
This will perform a single-user installation of Nix, meaning that
/nix is owned by the invoking user. You should
run this under your usual user account, not as
@@ -33,51 +50,8 @@ and .profile to source
the NIX_INSTALLER_NO_MODIFY_PROFILE environment
variable before executing the install script to disable this
behaviour.
-
-
-
-You can also download a binary tarball that contains Nix and all
-its dependencies. (This is what the install script at
-https://nixos.org/nix/install does automatically.) You
-should unpack it somewhere (e.g. in /tmp), and
-then run the script named install inside the binary
-tarball:
-
-
-alice$ cd /tmp
-alice$ tar xfj nix-1.8-x86_64-darwin.tar.bz2
-alice$ cd nix-1.8-x86_64-darwin
-alice$ ./install
-
-
-You can uninstall Nix simply by running:
@@ -86,5 +60,131 @@ $ rm -rf /nix
+
+
+ Multi User Installation
+
+ The multi-user Nix installation creates system users, and a system
+ service for the Nix daemon.
+
+
+
+ Supported Systems
+
+
+ Linux running systemd, with SELinux disabled
+
+ macOS
+
+
+
+ You can instruct the installer to perform a multi-user
+ installation on your system:
+
+
+ sh <(curl https://nixos.org/nix/install) --daemon
+
+
+
+
+ The multi-user installation of Nix will create build users between
+ the user IDs 30001 and 30032, and a group with the group ID 30000.
+
+ You should run this under your usual user account,
+ not as root. The script will invoke
+ sudo as needed.
+
+
+
+ If you need Nix to use a different group ID or user ID set, you
+ will have to download the tarball manually and edit the install
+ script.
+
+
+
+ The installer will modify /etc/bashrc, and
+ /etc/zshrc if they exist. The installer will
+ first back up these files with a
+ .backup-before-nix extension. The installer
+ will also create /etc/profile.d/nix.sh.
+
+
+ You can uninstall Nix with the following commands:
+
+
+sudo rm -rf /etc/profile/nix.sh /etc/nix /nix ~root/.nix-profile ~root/.nix-defexpr ~root/.nix-channels ~/.nix-profile ~/.nix-defexpr ~/.nix-channels
+
+# If you are on Linux with systemd, you will need to run:
+sudo systemctl stop nix-daemon.socket
+sudo systemctl stop nix-daemon.service
+sudo systemctl disable nix-daemon.socket
+sudo systemctl disable nix-daemon.service
+sudo systemctl daemon-reload
+
+# If you are on macOS, you will need to run:
+sudo launchctl unload /Library/LaunchDaemons/org.nixos.nix-daemon.plist
+sudo rm /Library/LaunchDaemons/org.nixos.nix-daemon.plist
+
+
+ There may also be references to Nix in
+ /etc/profile,
+ /etc/bashrc, and
+ /etc/zshrc which you may remove.
+
+
+
+
+
+ Installing a pinned Nix version from a URL
+
+
+ NixOS.org hosts version-specific installation URLs for all Nix
+ versions since 1.11.16, at
+ https://nixos.org/releases/nix/nix-VERSION/install.
+
+
+
+ These install scripts can be used the same as the main
+ NixOS.org installation script:
+
+
+ sh <(curl https://nixos.org/nix/install)
+
+
+
+
+ In the same directory of the install script are sha256 sums, and
+ gpg signature files.
+
+
+
+
+ Installing from a binary tarball
+
+
+ You can also download a binary tarball that contains Nix and all
+ its dependencies. (This is what the install script at
+ https://nixos.org/nix/install does automatically.) You
+ should unpack it somewhere (e.g. in /tmp),
+ and then run the script named install inside
+ the binary tarball:
+
+
+
+alice$ cd /tmp
+alice$ tar xfj nix-1.8-x86_64-darwin.tar.bz2
+alice$ cd nix-1.8-x86_64-darwin
+alice$ ./install
+
+
+
+
+ If you need to edit the multi-user installation script to use
+ different group ID or a different user ID range, modify the
+ variables set in the file named
+ install-multi-user.
+
+