 |
 |
 |
 |
Tip
Full installation and configuration instructions live at serpantinum.dev.
Important
Migrating from v1: All previous configuration will be backed up and unused. Configuration of compositor settings such as monitors, keybinds, and autostart is now up to you, as the project migrated from being dotfiles to being a shell.
For Arch-based distributions (including systemd, OpenRC, and other init systems) and for Fedora-based distributions such as Nobara and Ultramarine, run the automated installation script. It detects your distribution and uses pacman or dnf.
Use this installer:
curl -fsSL install.serpantinum.dev | bashIf this doesn't work, use:
bash -c "$(curl -fsSL https://raw.githubusercontent.com/ilyamiro/serpantinum/master/install/install.sh)"Note
To update, when or if you recieve a notification about the new version being available, just run the script again and choose "update"
See the NixOS installation guide for flake setup, the NixOS and Home Manager modules, and updating.
Hyprland, Niri, Sway and Mango. The installer detects the running compositor and deploys its configuration. On Fedora, Mango is installed from the Terra repository.
To run the shell, launch serpantinumd start
For configuration, see the configuration guide.
- Special thanks to Darkall44/Qylock for providing a gorgeous material SDDM theme!
Copyright (C) 2026 Illia Miroshnichenko
This project is licensed under the GNU Affero General Public License version 3, or (at your option) any later version. See the LICENSE.md file for the full license text.