NixOS
The flake provides a Gnoblin session for x86_64 Linux. Use Nixpkgs unstable for the current GNOME dependency stack.
Stable channels
Gnoblin does not currently provide installable packages for NixOS 25.05, 25.11, or 26.05. GNOME 51 requires newer integration libraries than those channels provide. In particular, 25.05 lacks libglycin; 25.11 has Wayland 1.24; and 26.05 has Wayland 1.25, while Gnoblin requires Wayland 1.26.
The flake exposes the exact pinned-channel assessment for integrators:
nix eval --json github:kierandrewett/gnoblin#lib.nixChannelEvaluations.x86_64-linuxlib.nixChannelPackages names each channel explicitly. For example, the following reports why 25.11 cannot be installed:
nix build github:kierandrewett/gnoblin#lib.nixChannelPackages.x86_64-linux.nixos_25_11Each stable entry stops before installation and prints its recorded blockers. It does not fall back to the unstable package or replace your system libraries.
1. Add the flake input
In your existing flake.nix:
inputs.gnoblin.url = "github:kierandrewett/gnoblin";This keeps Gnoblin's own pinned Nixpkgs input. If your system already uses a compatible unstable revision, you can add inputs.gnoblin.inputs.nixpkgs.follows = "nixpkgs";.
2. Enable the module
Add these entries to your host's nixosSystem definition, where inputs is the set of flake inputs:
modules = [
inputs.gnoblin.nixosModules.default
./configuration.nix
{ programs.gnoblin.enable = true; }
];Keep your existing display manager. If you have none, enable GDM in configuration.nix:
services.displayManager.gdm.enable = true;3. Rebuild and log in
From your system configuration directory, run your usual rebuild command:
sudo nixos-rebuild switch --flake .Install a shell, then log out and select Gnoblin. Continue with configuration.
Update or remove
Update the flake input and rebuild to update Gnoblin. Log out and in afterward.
To remove it, remove the Gnoblin module and enable option, then rebuild. Gnoblin's private runtime does not replace the GNOME packages in your system.