summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorMichael Hoang <enzime@users.noreply.github.com>2024-11-09 03:14:01 +1100
committerMichael Hoang <enzime@users.noreply.github.com>2024-11-09 22:26:53 +1100
commit5a1ae6a6e41362fb52a682fd3d5f19585131d5de (patch)
tree4774313a6a4b97f2d1c38d1435c5ac1f8ddb10dc /README.md
parent050b7db4451bbca9798d09661f098cb0033779b5 (diff)
readme: add prerequisites section
Diffstat (limited to 'README.md')
-rw-r--r--README.md11
1 files changed, 9 insertions, 2 deletions
diff --git a/README.md b/README.md
index 82a094d..b9e3de7 100644
--- a/README.md
+++ b/README.md
@@ -9,9 +9,16 @@ Nix modules for darwin, `/etc/nixos/configuration.nix` for macOS.
This project aims to bring the convenience of a declarative system approach to macOS.
nix-darwin is built up around [Nixpkgs](https://github.com/NixOS/nixpkgs), quite similar to [NixOS](https://nixos.org/).
-## Installing
+## Prerequisites
+
+The only prerequisite is a Nix implementation, both Nix and Lix are supported.
+
+As the official Nix installer does not include an automated uninstaller, and manual uninstallation on macOS is a complex process, we recommend using one of the following installers instead:
-To install nix-darwin, a working installation of [Nix](https://github.com/NixOS/nix#installation) is required.
+- The [Nix installer from Determinate Systems](https://github.com/DeterminateSystems/nix-installer?tab=readme-ov-file#determinate-nix-installer) is only recommended for use with flake-based setups. **Make sure you use it without the `--determinate` flag**. The `--determinate` flag installs the Determinate Nix distribution which does not work out of the box with nix-darwin.
+* The [Lix installer](https://lix.systems/install/#on-any-other-linuxmacos-system) supports both flake-based and channel-based setups.
+
+## Installing
If you wish to use nix-darwin with flakes, please refer to the [flakes](#flakes) section.