Fedora
Install Veila from the prebuilt RPM package on Fedora and similar RPM-based systems
Download an RPM from GitHub releases:
- x86_64:
veila-<version>.x86_64.rpm - aarch64:
veila-<version>.aarch64.rpm
wget -O /tmp/veila-0.5.0-1.x86_64.rpm https://github.com/naurissteins/Veila/releases/download/0.5.0/veila-0.5.0-1.x86_64.rpmInstall package:
sudo dnf install /tmp/veila-0.5.0-1.x86_64.rpmdnf 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/veilaIf the watcher fails, check veila logs --journal --idle and its session environment. You can run veila idle from the compositor instead.