Skip to content

NixOS

Waxlight is packaged as a Nix flake for NixOS and other Nix-based Linux systems on x86_64-linux. The package builds the launcher with GTK3 and WebKitGTK 4.1; no steam-run, nix-ld, or manual library setup is required.

With flakes enabled, start the latest source revision directly:

Terminal window
nix run github:AmadoMuerte/Waxlight-launcher
Terminal window
nix profile install github:AmadoMuerte/Waxlight-launcher

This also adds Waxlight to the desktop application launcher. To remove it later:

Terminal window
nix profile remove Waxlight-launcher

Add Waxlight as an input and include its package in environment.systemPackages:

{
inputs = {
nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
waxlight.url = "github:AmadoMuerte/Waxlight-launcher";
};
outputs = { nixpkgs, waxlight, ... }: {
nixosConfigurations.my-machine = nixpkgs.lib.nixosSystem {
modules = [
({ pkgs, ... }: {
environment.systemPackages = [ waxlight.packages.${pkgs.system}.default ];
})
];
};
};
}

User data stays in the normal XDG directories, including ~/.config/waxlight/. Instances, mods, logs, configuration, and account sessions are never written into the immutable Nix store.

The launcher self-updater is disabled for Nix installations: Waxlight must not replace an executable inside /nix/store. Update the package through Nix instead:

Terminal window
nix profile upgrade Waxlight-launcher

For the complete first-run flow, continue with Getting started.