NixOS

Install Gnoblin on NixOS with its flake. See platform support for the supported releases and architectures.

Install

1. Add Gnoblin to the inputs of your flake.nix:

   NixCopy

   inputs.gnoblin.url = "github:kierandrewett/gnoblin";

   To stay on one release, add a release tag from the Gnoblin releases to the address.

2. Add the module to your host's nixosSystem definition, where inputs is the set of flake inputs:

   NixCopy

   modules = [
     inputs.gnoblin.nixosModules.default
     ./configuration.nix
     { programs.gnoblin.enable = true; }
   ];

3. Keep your display manager. If you have none, enable GDM in configuration.nix:

   NixCopy

   services.displayManager.gdm.enable = true;

4. Rebuild from your system configuration directory:

   ShellCopy

   sudo nixos-rebuild switch --flake .

Next steps

Install a desktop shell and log in.

Update

Update the flake input, then rebuild:

nix flake update gnoblin
sudo nixos-rebuild switch --flake .

Log out and back in to use the new version.

Remove

Remove the Gnoblin module and the programs.gnoblin.enable line, then rebuild. Your shell and your configuration stay.

See troubleshooting if the session does not start.

More information

• NixOS Wiki: flakes