Getting started with Determinate

Determinate is an all-in-one Nix toolchain that includes Determinate Nix and FlakeHub. Determinate is available on macOS, most Linux systems (including SELinux), and Windows Subsystem for Linux (WSL).

We recommend that macOS users use Determinate.pkg, our graphical installer. Click the button below to install now or read more below:

Determinate.pkg for macOS

Get the latest version of Determinate Nix on your machine

Most Linux and WSL users should use Determinate Nix Installer to install Determinate. It takes just one command:

curl --proto '=https' --tlsv1.2 -sSf -L https://install.determinate.systems/nix | \
  sh -s -- install --determinate

If you use NixOS or nix-darwin you can install Determinate using the determinate flake.

Using the determinate flake

NixOS and nix-darwin users can install Determinate using the determinate flake. To add it as a flake input:

{
  inputs.determinate.url = "https://flakehub.com/f/DeterminateSystems/determinate/0.1";
}

NixOS

If you’re a NixOS user, you can quickly set up Determinate Nix using the nixosModules.default module output from the determinate flake. Here’s an example NixOS configuration:

{
  inputs.determinate.url = "https://flakehub.com/f/DeterminateSystems/determinate/0.1";
  inputs.nixpkgs.url = "https://flakehub.com/f/NixOS/nixpkgs/0.2405.0";
 
  outputs = { determinate, nixpkgs, ... }: {
    nixosConfigurations.my-workstation = nixpkgs.lib.nixosSystem {
      system = "x86_64-linux";
      modules = [
        # Load the Determinate module
        determinate.nixosModules.default
      ];
    };
  };
}

nix-darwin

If you’re a nix-darwin user on macOS, you can quickly set up Determinate using the darwinModules.default module output from the determinate flake. Here’s an example nix-darwin configuration:

{
  inputs.determinate.url = "https://flakehub.com/f/DeterminateSystems/determinate/0.1";
  inputs.nix-darwin.url = "github:LnL7/nix-darwin";
 
  outputs = { determinate, nix-darwin, ... }: {
    darwinConfigurations.my-workstation-aarch64-darwin = nix-darwin.lib.darwinSystem {
      system = "aarch64-darwin";
      modules = [
        # Load the Determinate module
        determinate.darwinModules.default
      ];
    };
  };
}

Determinate.pkg

You can install Determinate on macOS using Determinate Systems’ provided .pkg file. Download and run it by clicking here:

Determinate.pkg for macOS

Get the latest version of Determinate Nix on your machine

The Determinate package is fully signed and notarized. Re-running the installer is safe and upgrades Determinate in place.

Log in to FlakeHub

Once you’re set up with Determinate Nix, you can log in to FlakeHub using Determinate Nixd:

determinate-nixd login

By default, the login command triggers a FlakeHub login flow that includes generating a JSON Web Token (JWT) in the FlakeHub UI and copy-pasting it into your terminal. Once logged in, you can use private flakes and FlakeHub Cache.

You can now download private flakes and artifacts from your private binary cache.