diff options
| author | Ana Hobden <operator@hoverbear.org> | 2023-01-16 11:35:12 -0800 |
|---|---|---|
| committer | Ana Hobden <operator@hoverbear.org> | 2023-01-16 11:38:50 -0800 |
| commit | 763c1dfc2b0875251385d9b228c0fc1bfd654bf4 (patch) | |
| tree | 8d4702e9f7f21c031f0773a9a8235d3481236180 /doc/manual/src | |
| parent | 1df3d62c769dc68c279e89f68fdd3723ed3bcb5a (diff) | |
Expand installation.md
Changes the `quick-start.md` to recommend a multi-user install, since
single-user is not supported on MacOS and https://nixos.org/download.html
recommends multi-user.
Expands `installation.md` to reflect wording on https://nixos.org/download.html
Diffstat (limited to 'doc/manual/src')
| -rw-r--r-- | doc/manual/src/installation/installation.md | 40 | ||||
| -rw-r--r-- | doc/manual/src/quick-start.md | 12 |
2 files changed, 44 insertions, 8 deletions
diff --git a/doc/manual/src/installation/installation.md b/doc/manual/src/installation/installation.md index b40c5b95f..dafdeb667 100644 --- a/doc/manual/src/installation/installation.md +++ b/doc/manual/src/installation/installation.md @@ -1,2 +1,38 @@ -This section describes how to install and configure Nix for first-time -use. +# Installation + +This section describes how to install and configure Nix for first-time use. + +The current recommended option on Linux and MacOS is [multi-user](#multi-user). + +## Multi-user + +This installation offers better sharing, improved isolation, and more security +over a single user installation. + +This option requires either: + +* Linux running systemd, with SELinux disabled +* MacOS + +```console +$ bash <(curl -L https://nixos.org/nix/install) --daemon +``` + +## Single-user + +> Single-user is not supported on Mac. + +This installation has less requirements than the multi-user install, however it +cannot offer equivalent sharing, isolation, or security. + +This option is suitable for systems without systemd. + +```console +$ bash <(curl -L https://nixos.org/nix/install) --no-daemon +``` + +## Distributions + +The Nix community maintains installers for several distributions. + +They can be found in the [`nix-community/nix-installers`](https://github.com/nix-community/nix-installers) repository. diff --git a/doc/manual/src/quick-start.md b/doc/manual/src/quick-start.md index b54e73500..e11549984 100644 --- a/doc/manual/src/quick-start.md +++ b/doc/manual/src/quick-start.md @@ -4,16 +4,16 @@ This chapter is for impatient people who don't like reading documentation. For more in-depth information you are kindly referred to subsequent chapters. -1. Install single-user Nix by running the following: +1. Install Nix by running the following: ```console - $ bash <(curl -L https://nixos.org/nix/install) + $ bash <(curl -L https://nixos.org/nix/install) --daemon ``` - This will install Nix in `/nix`. The install script will create - `/nix` using `sudo`, so make sure you have sufficient rights. (For - other installation methods, see - [here](installation/installation.md).) + The install script will use `sudo`, so make sure you have sufficient rights. + On Linux, `--daemon` can be omitted for a single-user install. + + For other installation methods, see [here](installation/installation.md). 1. See what installable packages are currently available in the channel: |