Debian / Ubuntu
Install Veila from the prebuilt Debian package on Debian and Ubuntu based systems
Download a Debian package from GitHub releases:
- x86_64:
veila_<version>-1_amd64.deb - aarch64:
veila_<version>-1_arm64.deb
wget -O /tmp/veila_0.5.0-1_arm64.deb https://github.com/naurissteins/Veila/releases/download/0.5.0/veila_0.5.0-1_arm64.debInstall package:
sudo apt install /tmp/veila_0.5.0-1_arm64.debapt also installs required dependencies.
The package installs:
| Path | Description |
|---|---|
/usr/bin/veila | Lock, idle watcher, and CLI |
/usr/bin/veilad | Deprecated compatibility link to veila |
/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/veila.service | Optional idle/sleep watcher service |
/usr/lib/systemd/user/veilad.service | Deprecated alias for veila.service |
First Launch
Lock without a service:
veila lockStays in the foreground until unlock.
For keybinds or external idle tools:
veila lock --daemonize --wait-readyFor example, in Hyprland:
bind = SUPER, Escape, exec, veila lock --daemonize --wait-readyOptional: start the idle/sleep watcher:
systemctl --user enable --now veila.serviceOr start veila idle from your compositor. Run one watcher per display. For sweetidle, swayidle, and sleep hooks, see Lock control.
No config is required. Customize the default theme or choose another theme.
Troubleshooting
If the correct password is rejected, check /etc/pam.d/veila:
ls /etc/pam.d/veilaRun veila doctor to check PAM. A missing file falls back to common-auth; reinstall the package to restore it.
If the watcher fails, check veila logs --journal --idle and its session environment. You can run veila idle from the compositor instead.