nix-super/doc/manual/src/installation/index.md

# 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

> **Updating to macOS 15 Sequoia**
>
> If you recently updated to macOS 15 Sequoia and are getting
> ```console
> error: the user '_nixbld1' in the group 'nixbld' does not exist
> ```
> when running Nix commands, refer to GitHub issue [NixOS/nix#10892](https://github.com/NixOS/nix/issues/10892) for instructions to fix your installation without reinstalling.

```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.
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 2023-01-16 21:35:12 +02:00			`# 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`

doc: add admonitions for macOS 15 Sequoia update (#11487) The impending release of macOS 15 Sequoia will break many existing nix installs on macOS, which may lead to an increased number of people who are looking to try to reinstall Nix without noticing the open/pinned issue (#10892) that explains the problem and outlines how to migrate existing installs. These admonitions are a short-term measure until we are over the hump and support volumes dwindle. 2024-09-11 20:50:47 +03:00			`> Updating to macOS 15 Sequoia`
			`>`
			`> If you recently updated to macOS 15 Sequoia and are getting`
			> ```console
			`> error: the user '_nixbld1' in the group 'nixbld' does not exist`
			> ```
			`> when running Nix commands, refer to GitHub issue [NixOS/nix#10892](https://github.com/NixOS/nix/issues/10892) for instructions to fix your installation without reinstalling.`

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 2023-01-16 21:35:12 +02:00			```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.