Skip to Content
Veila
Installation

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

Install package:

sudo dnf install /tmp/veila-0.5.0-1.x86_64.rpm

dnf 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

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