Skip to content

Mobile app

The mobile app brings one-tap VPN to phones. Unlike the desktop clients there is nothing to configure by hand: the user installs the app and scans a QR code you show them — that single scan connects the app to your server, activates the device, and assigns it to the right customer.

Android is available now via Google Play; iOS is in preparation.

Prerequisites

  • A running backend (Community or Pro) reachable over HTTPS from the internet.
  • An Android phone with Google Play and a camera.

Steps

1. Show the pairing code (admin)

In the admin panel, open the customer the device belongs to, go to the Endpoints tab, and generate a pairing QR code. The code is one-time and valid for 15 minutes — generate it when the user is ready.

2. Install the app (user)

Install Valenius from Google Play and open it.

3. Scan the code (user)

In the app, scan the pairing QR code from the admin's screen. That's the whole setup: the app now knows your server, and the device is activated and assigned to the customer — no pending step, no address to type.

If scanning isn't possible, the app also accepts the server address entered manually; the device then appears as a pending client for you to activate in the admin panel, like a desktop install.

4. Connect

Tap Connect in the app. On the very first connect, Android shows its system VPN permission dialog — accept it.

Verify it works

  1. The app shows the tunnel as connected, with a verified check.
  2. In the admin panel, the device shows as online (green).

Common problems

The QR code is rejected. Pairing codes are one-time and expire after 15 minutes. Generate a fresh one on the customer's Endpoints tab and scan again.

The scanner doesn't open. The app needs camera permission — allow it in Android's app settings, or use manual entry instead.

Connect does nothing. The Android VPN permission dialog was declined. Tap Connect again and accept it.

What about iPhones? The iOS app is in preparation and will use the same pairing flow. Until then, mobile means Android.

Updates? The app updates through Google Play like any other app — nothing to manage on your backend.