Debian / Ubuntu
Install Veila from the prebuilt Debian package on Debian and Ubuntu based systems
Download the latest veila_<version>-1_amd64.deb file from the GitHub releases, then install it with apt:
wget -O /tmp/veila_0.4.1-1_amd64.deb https://github.com/naurissteins/Veila/releases/download/0.4.1/veila_0.4.1-1_amd64.debInstall package:
sudo apt install /tmp/veila_0.4.1-1_amd64.debUsing apt install veila_.deb is recommended because it can resolve package dependencies automatically.
The package installs:
| Path | Description |
|---|---|
/usr/bin/veila | User-facing control CLI |
/usr/bin/veilad | Veila daemon |
/usr/bin/veila-curtain | Secure session-lock curtain |
/usr/share/veila/ | Bundled themes, wallpapers, fonts, and icons |
/usr/share/man/man1/veila.1 | CLI reference man page |
/etc/pam.d/veila | PAM service used for password authentication |
/usr/lib/systemd/user/veilad.service | Optional systemd user service |
/usr/lib/systemd/user/veila-idle.service | Optional idle and sleep lock monitor service |
First Launch
Start the daemon:
veiladFor daily use, start veilad from your compositor config. For Hyprland:
exec-once = veiladIf you prefer systemd user services and your session environment is correctly imported:
systemctl --user enable --now veilad.serviceLock directly from the CLI:
veila lockExample keybind for Hyprland:
bind = SUPER, Escape, exec, veila lockThat is enough to get started. It works out of the box and no extra configuration is required for a basic setup.
You do not need to go through the full configuration reference just to make small changes. For simple tweaks like changing the wallpaper, avatar, clock or date format, or a few widget options, start with the default theme or pick another theme you like and follow the instructions on that theme page.
Troubleshooting
If the lockscreen opens but the correct password is rejected, check that /etc/pam.d/veila exists:
ls /etc/pam.d/veilaIf systemctl --user enable --now veilad.service fails, prefer starting veilad from your compositor config first. Some sessions do not pass the correct Wayland or logind environment into user services automatically.