Lukec: Create a page for Noctalia Shell with installation instructions

2026-03-24T22:09:29Z

Create a page for Noctalia Shell with installation instructions

New page

[https://github.com/noctalia-dev/noctalia-shell Noctalia Shell] is a sleek and minimal desktop shell thoughtfully crafted for Wayland.

Noctalia provides native support for [[Niri]], [[Hyprland]], [[Sway]], [[Scroll]], [[Labwc]] and [[MangoWC]]. Other Wayland compositors may work but could require additional configuration for compositor-specific features like workspaces and window management.<ref>https://github.com/noctalia-dev/noctalia-shell/blob/d1c0374f73ea687ae33b30fe6c4257dc0995d4f3/README.md</ref>

== Installation<ref>https://docs.noctalia.dev/getting-started/nixos/</ref> ==
A Nix package for Noctalia is currently available on the unstable channel.
{{File|3=environment.systemPackages = with pkgs; [
noctalia-shell
];|name=/etc/nixos/configuration.nix|lang=nix}}

=== Noctalia Shell Flake ===
You can also get the latest Git version of Noctalia by using [[flakes]].
{{File|3={
description = "NixOS configuration with Noctalia";

inputs = {
nixpkgs.url = "github:nixos/nixpkgs/nixos-unstable";

noctalia = {
url = "github:noctalia-dev/noctalia-shell";
inputs.nixpkgs.follows = "nixpkgs";
};
};

outputs = inputs@{ self, nixpkgs, ... }: {
nixosConfigurations.awesomebox = nixpkgs.lib.nixosSystem {
specialArgs = { inherit inputs; };
modules = [
# ... other modules
./noctalia.nix
];
};
};
}|name=flake.nix|lang=nix}}
If not using the NixOS or Home Manager module, we can install Noctalia using:
{{File|3={ pkgs, inputs, ... }:
{
environment.systemPackages = with pkgs; [
inputs.noctalia.packages.${pkgs.stdenv.hostPlatform.system}.default
];
}|name=noctalia.nix|lang=nix}}
Alternatively, we can just enable Noctalia using the NixOS or Home Manager module. For example, for Home Manager:
{{File|3={ pkgs, inputs, ... }:
{
home-manager.users.foobar = {
# import the home manager module
imports = [
inputs.noctalia.homeModules.default
];

programs.noctalia-shell = {
enable = true;
settings = {
# configure options
};
};
};
}|name=noctalia.nix|lang=nix}}

Noctalia Shell - Revision history

Lukec: Create a page for Noctalia Shell with installation instructions