Check out , the best place to discover and publish Nix flakes, brought to you by .

We use a single, first-party analytics cookie to focus our limited time and energy on the most important documentation. Check out our privacy policy .

1. Get Nix running on your system

Quick start / Get Nix running on your system
Guide 1 of 8
In this guide

Get Nix running on your Linux or macOS system using nix-installer

Verify that your installed Nix is working as expected

The target audience for the quick start

We wrote this Zero to Nix quick start with one specific audience in mind: people who have heard about Nix but don’t yet know much about it and aren’t quite sure where to start. We intend it less as a how-to guide for using Nix in your everyday workflows and more to provide you a glimpse into Nix’s feature set and some of those initial “a-ha!” moments that make you feel empowered to go further.

If you’re already familiar with Nix and are looking for guidance on using it in your day job, you may still get some value out of the quick start but you may be better served with more practical, guide-driven resources like nix.dev.

Welcome! It’s great to see that you’re interested in Nix. In this quick start, we’ll get Determinate Nix installed on your system. Then we’ll provide you with a small taste of Nix’s feature set by accomplishing some practical things, such as creating a development environment and building a package using Nix.

Determinate Nix versus upstream Nix

Determinate Nix is Determinate Systems’ downstream distribution of the upstream Nix project. It offers a variety of features not available in the upstream version, such as lazy trees, parallel evaluation, and the native Linux builder.

We’ll install Determinate Nix using Determinate Nix Installer, a tool that tailors the installation process to your system. It supports these platforms:

macOS

64-bit ARM and 64-bit AMD/Intel

Linux

64-bit ARM and 64-bit AMD/Intel

Windows Subsystem for Linux (WSL)

64-bit ARM and 64-bit AMD/Intel

Install Determinate Nix

On macOS, we recommend using our package installer:

Logo for graphical installer

Or if you prefer the command line:

One command to install Nix on macOS
curl --proto '=https' --tlsv1.2 -sSf -L https://install.determinate.systems/nix | sh -s -- install

On Linux, we recommend installing using the Determinate Nix Installer CLI:

One command to install Nix on Linux
curl --proto '=https' --tlsv1.2 -sSf -L https://install.determinate.systems/nix | sh -s -- install

On Windows Subsystem for Linux, we recommend installing using the Determinate Nix Installer CLI:

One command to install Nix on Windows Subsystem for Linux
curl --proto '=https' --tlsv1.2 -sSf -L https://install.determinate.systems/nix | sh -s -- install

Installation is also available via several Mobile Device Management (MDM) platforms.

Once the installer has finished, open a new terminal session and the nix executable should be in your $PATH. To verify that:

Display the Nix version
nix --version

This should print the version information.

🚀 Success! You now have Determinate Nix installed and ready to go on your system.

How to contribute to Zero to Nix

If you’re interested in contributing to Zero to Nix, see the manual in the project repo for some suggestions.


Was this page helpful?