Skip to content

Getting StartedΒΆ

Starting with Nix Toolbox is really simple. Make sure you are running a system with Toolbx or Distrobox installed.

Create Nix Toolbox container

toolbox create --image ghcr.io/thrix/nix-toolbox:42
distrobox create --image ghcr.io/thrix/nix-toolbox:42

This will create the nix-toolbox the container.

The Nix and Home Manager setup is then performed when you first time enter the container:

toolbox enter nix-toolbox-42
distrobox enter nix-toolbox-42

Note

Do not be afraid, the next start of the container will be as quick as with Fedora Toolbox.

Note

Depending on your setup, the first time setup can take a long time, especially if you already have some Home Manager configuration available.

The Home Manager configuration is optional, and you can skip it to have only the nix command.

After the Nix is installed, you can opt-in to install Home Manager.

Info

Currently, the project provides an empty Home Manager configuration. Please take a look at the Examples to get most out of Nix Toolbox. We are planning to throw out a more reasonable template later for easier onboarding.

The home manager configuration is available at ~/.config/home-manager/home.nix. When changing the Home Manager configuration it is a good practice to put it under revision control to keep history of your changes to be able to easily replicate the setup on another computer.