Linux client

The Linux client ships as a Debian package (.deb). It installs a system service (the daemon) plus a tray app for the desktop session, and keeps itself up to date automatically after that. It relies only on packages from the distribution's own repositories.

Prerequisites

• A running backend (Community or Pro).
• A Debian- or Ubuntu-based desktop with systemd, and sudo rights on the machine (once, for the install).
• The .deb package — download it from your backend's public downloads page, https://vpn.example.com/downloads (it serves whatever you've published on Admin → Releases).

Steps

1. Install the package

sudo apt install ./valenius_*.deb

apt pulls in the required system packages automatically and starts the daemon.

2. Start the tray app

Log out and back in — the tray app starts automatically with the desktop session. (It also appears in the application menu as Valenius if you want to start it right away.)

3. Enter your server address

On first run the tray asks for the server address. Enter your backend hostname — for example vpn.example.com (the https:// is fixed) — and confirm.

4. Activate the machine in the admin panel

The machine now appears in your admin panel as a pending client (the Overview page shows a Pending counter — click it). Open the new client, assign it to its customer, and click Activate. The client picks this up on its own within a few minutes.

Scripted rollout

To skip the first-run prompt, pre-fill the server address and API key in /etc/valenius/appsettings.json (the API key is shown under Admin → Settings → Client connectivity), then restart with sudo systemctl restart valenius.

Verify it works

1. systemctl status valenius shows active (running).
2. The Valenius tray icon is visible in the desktop session.
3. In the admin panel, the client shows as online (green) after activation.
4. Give it a VPN profile (see First steps) and connect from the tray — a green check appears when the tunnel is up and verified.

Common problems

No tray icon after logging back in. On GNOME, tray icons need the AppIndicator shell extension — install and enable it, then log out and in again. The daemon works either way; only the icon is affected.

The machine never appears as pending in the admin panel. The server address is wrong or unreachable from the machine. Click the tray icon — if it still asks for the server address, re-enter it. Check the daemon's view with journalctl -u valenius -f.

apt install reports missing packages. Make sure you're on a Debian/Ubuntu-based distribution and ran apt (not dpkg -i) — apt resolves the dependencies for you.

Updates: do I ever reinstall by hand? No. The daemon checks your backend hourly and updates itself — publishing a new version on Admin → Releases is all you do. Learn more →