Previews
 |
 |
 |
 |
Installation
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.
Arch Linux and its derivatives
For Arch-based distributions (including systemd, OpenRC, and other init systems), run the automated installation script.
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"
NixOS
See the NixOS installation guide for flake setup, the NixOS and Home Manager modules, and updating.
Running
To run the shell, launch serpantinumd start
For configuration, see the configuration guide.
Credits
- Special thanks to Darkall44/Qylock for providing a gorgeous material SDDM theme!
Thanks to all contributors
License
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.