nix-super/doc/manual/src/installation/index.md
Travis A. Everett 48477d4a3e
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 17:50:47 +00:00

1.3 KiB

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

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

error: the user '_nixbld1' in the group 'nixbld' does not exist

when running Nix commands, refer to GitHub issue NixOS/nix#10892 for instructions to fix your installation without reinstalling.

$ 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.

$ 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 repository.