3.4 KiB
| title | description | date | author |
|---|---|---|---|
| Installing Lix | or: how to make your configuration Delicious | 2024-04-27 | Lix Team |
Whether you're a new or returning user, we're thrilled you've decided to pick up Lix!
Lix works out-of-the-box on most Linux and MacOS systems, including with system management tools such as home-manager and nix-darwin -- but, like any Nix-based system, some Nix background knowledge is recommended before installation.
If you're new to the Nix ecosystem, you may want to check out some community resources first, to get familiar with how Nix works.
On NixOS
If you haven't already installed NixOS, do so using any upstream install image and the instructions in the NixOS Manual. Then, follow the instructions for either:
depending on how you prefer to configure your system.
On an Existing nix-darwin Install
If you already have a nix-darwin installation, you can use the same instructions as installing on a NixOS-based system. Follow the instructions for either:
depending on how you prefer to configure your system.
On Any Other Linux/MacOS System
You can either perform a new install, or choose to upgrade an existing install to Lix.
New Installs
The easiest way to install Lix is to use the Lix Installer1. Open a terminal, and run the following command:
$ curl -sSf -L https://install.lix.systems/lix | sh -s -- install
The installer will guide you through installing Lix -- and once it's finished, you'll have a full, working installation. If you're not sure what to do, now is a great time to check out some of the community's resources on Nix.
Existing Installs
If you have an existing Nix installation, you should be able to upgrade by using a variant
of the upgrade-nix command.
If you have flakes enabled, the following command should perform an upgrade:
$ sudo nix run 'https://git.lix.systems/lix-project/lix' -- upgrade-nix
If you don't have flakes enabled, you can perform a slightly more complex command:
$ ***TODO FIXME***
You should now have an upgraded version of Nix. You can verify this by asking Lix to report its version:
$ nix --version
nix (Lix, like Nix) 2.90.0-lix
As long as you see Lix in the output, you're good! If you're not sure what to do now, it's a
great time to check out some of the community's resources on Nix.
Having Trouble?
If you're having difficulty installing Lix, don't panic! Hop on over to our community page, and check out the various ways to find help.
-
a customized variant of the Determinant Nix Installer. ↩︎