Skip to Content
Veila
Installation

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.deb

Install package:

sudo apt install /tmp/veila_0.5.0-1_arm64.deb

apt also installs required dependencies.

The package installs:

PathDescription
/usr/bin/veilaLock, idle watcher, and CLI
/usr/bin/veiladDeprecated compatibility link to veila
/usr/share/veila/Bundled themes, wallpapers, fonts, and icons
/usr/share/man/man1/veila.1CLI reference man page
/etc/pam.d/veilaPAM service used for password authentication
/usr/lib/systemd/user/veila.serviceOptional idle/sleep watcher service
/usr/lib/systemd/user/veilad.serviceDeprecated alias for veila.service

First Launch

Lock without a service:

veila lock

Stays in the foreground until unlock.

For keybinds or external idle tools:

veila lock --daemonize --wait-ready

For example, in Hyprland:

bind = SUPER, Escape, exec, veila lock --daemonize --wait-ready

Optional: start the idle/sleep watcher:

systemctl --user enable --now veila.service

Or 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/veila

Run 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.

On this page