One app · Linux

Guest WiFi.
At your Linux desk.

Create a voucher, share its code and keep your guest networks organised. The same WiFi Vouchers app, with room for your profiles and controllers.

WiFi Vouchers for Linux

Ubuntu 24.04 · amd64 · .deb or tar.gz

Version 2.0.0 · hosted on Fairu

Verify Ubuntu .deb · 15.1 MB

SHA-256 · wifi-vouchers-2.0.0-linux-x64.deb

90686e775c35b25a3aa3e9386f9fa185cfb8f9c7af72007547804c3f3cf371b1
Verify tar.gz archive · 15.1 MB

SHA-256 · wifi-vouchers-2.0.0-linux-x64.tar.gz

2413eacfbad78d61127503e81a4f65f0de400b85849a65ccc3ebb3966ff997b0

One script. Install and update.

Use Ubuntu 24.04 on an amd64 (x86-64) computer. Download the installer, then run it from your terminal:

curl --fail --show-error --proto '=https' https://getvouchers.app/install.sh -o install-wifi-vouchers.sh
bash install-wifi-vouchers.sh

Read the install script →

The script checks the latest package’s size, SHA-256 and identity before requesting administrator access. APT installs the system libraries it needs. If curl or Python is missing, first run sudo apt install curl python3.

To update, close WiFi Vouchers and run these same commands again. Your saved profiles stay in place. If your version is already current or newer, nothing changes. Updates run only when you start the script.

Once installed, open WiFi Vouchers from the application menu and set up your profile and controller. The installer never needs your UniFi API key. Remove the app with sudo apt remove wifi-vouchers.

Prefer a manual install?

On Ubuntu 24.04 (amd64), download the .deb and open a terminal in your Downloads folder. APT installs the required system libraries for you.

sudo apt install ./wifi-vouchers-2.0.0-linux-x64.deb

Open WiFi Vouchers from the application menu, or run wifi-vouchers. To uninstall: sudo apt remove wifi-vouchers.

This is a Debian-format package built for Ubuntu 24.04. Other Debian or Ubuntu versions are not yet tested. Prefer the archive if you want to keep the app in a folder without installing a package.

Use the archive instead.

  1. Download and extract the archive.

    Extract the entire tar.gz archive. Keep the executable, data directory and bundled libraries together.

  2. Install the runtime libraries and open the app.

    On Ubuntu 24.04, install the packages below, then run ./voucher_app from the extracted folder.

    sudo apt install libgtk-3-0t64 libsecret-1-0 libayatana-appindicator3-1 libjsoncpp25 libegl1 libgles2 default-jre-headless
    LD_LIBRARY_PATH="$PWD/lib:/usr/lib/jvm/default-java/lib/server" ./voucher_app
  3. Set up your profile and first controller.

    Enter a profile name, then connect using your controller address and API key. You can add more controllers to the same profile later.

    Follow the setup guide →

On your other devices.

Before you download.

Is this the Linux app or the proxy?

This is the WiFi Vouchers app for Linux. It lets you create, share and revoke guest vouchers. The optional unifi-voucher-proxy is a separate service between the app and your UniFi controller; it is not included in this download and is not needed for a direct connection.

Where do I download the app for my other devices?

Use the Apple App Store for iPhone and Mac, and Google Play for Android. Only Windows and Linux archives are hosted on Fairu.

Do I need a UniFi controller?

Yes. The app needs access to a compatible UniFi controller and its Integration API, or to your self-hosted proxy. To issue vouchers, configure a guest hotspot with voucher authentication on the controller first.

How do updates work?

Run the Linux installer again to install the latest published version. It checks the download checksum and uses APT to update the package and its dependencies. An already current or newer installation is left alone. There is no background updater. You can also install a downloaded .deb manually; archive users extract the new tar.gz into a separate folder.

What does the Linux install script do?

On Ubuntu 24.04 amd64, it reads our public release catalog, downloads the latest Debian package from Fairu and verifies its SHA-256, size and package identity before invoking APT. APT installs the required libraries and adds WiFi Vouchers to your application menu. It installs the app, not the optional proxy, and does not ask for your controller API key.