Install Gnoblin

Gnoblin is a window manager. A desktop shell provides the bar, dock and launcher, so you install both.

On this page

Quick setup
Choose your system
After installing
Optional packages

Quick setup

One script adds the Gnoblin repository and signing key for your system. It installs no packages. Read it at repo.gnoblin.org/setup.sh, then run it:

Shell

curl -fsSL https://repo.gnoblin.org/setup.sh | sh

The script asks which repositories you want. Gnoblin is selected. Press Space to select Bingux too, then press Enter. The guide for your system has the same steps by hand.

Choose your system

System	Guide
Fedora	Fedora
openSUSE	openSUSE
Debian	Debian
Arch Linux, CachyOS	Arch Linux
Alpine	Alpine
NixOS	NixOS
Anything else	Build from source

Each guide shows how to install, update and remove Gnoblin on that system. For the supported releases and architectures, see platform support.

After installing

Install a desktop shell.
Log out. At the login screen, choose your user, open the session menu and choose Gnoblin.
Log in and configure Gnoblin.

See troubleshooting if the session does not start.

Run gnoblin --version to see which version you have installed.

Optional packages

Gnoblin has optional packages for a portal backend, location prompts and scheduling rules. See optional packages.