Repolode
Submit
glenndehaan

glenndehaan/unifi-voucher-site

A web app and REST API for creating, managing and printing guest WiFi vouchers on UniFi networks.

View on GitHub
Stars
312
Forks
37
Open issues
1
Last commit
3 days ago

What is it?

UniFi Voucher Site is a self-hosted web application that generates and manages guest access vouchers for UniFi networks. Administrators create vouchers with configurable expiration, single or multi-use limits, upload and download speed caps, and data transfer quotas, then hand them out to guests.

Vouchers can be delivered in several ways: printed as PDFs or through ESC/POS network receipt printers on 80mm paper, emailed over SMTP, or generated by guests themselves through a kiosk page for public spaces. The project runs on Node.js with Express and EJS, and is deployed via Docker or as a Home Assistant app. Authentication can use the built-in password, OpenID Connect single sign-on, or be disabled.

It connects to a UniFi OS console using a UniFi API key, and requires UniFi OS v4.2.8+ with UniFi Network v9.1.119+ for version 8.x.

Key features

  • 01Create vouchers with configurable expiration, single or multi-use, and speed and data limits.
  • 02Print vouchers as PDFs or to ESC/POS network printers on 80mm paper.
  • 03Send vouchers by email through SMTP.
  • 04Provide a kiosk page where guests generate their own vouchers.
  • 05Support internal login, OpenID Connect SSO, or no authentication.
  • 06Expose a REST API protected by a bearer token.

Use cases

  • Issuing WiFi access codes to guests at cafés, hotels or co-working spaces.
  • Letting front-desk staff print vouchers on receipt printers.
  • Automating voucher creation from Home Assistant or other systems through the API.
  • Offering self-service internet access in public areas with a kiosk.

Quick start

  1. 1

    Set up the UniFi Hotspot Portal with voucher authentication enabled

  2. 2

    Create a docker-compose.yml from the README example and fill in your UniFi settings

Things to know

  • Version 8.x requires UniFi OS and does not work with the legacy UniFi Network Server.
  • Local Network API keys and Site Manager API keys are not interchangeable.
  • Requires a UniFi Hotspot Portal with voucher authentication enabled.

Topics

#unifi#wifi#guest-access#voucher#express#nodejs#docker#home-assistant#unifi-voucher-site

FAQ

What is unifi-voucher-site?
A web app and REST API for creating, managing and printing guest WiFi vouchers on UniFi networks. UniFi Voucher Site is a self-hosted web application that generates and manages guest access vouchers for UniFi networks. Administrators create vouchers with configurable expiration, single or multi-use limits, upload and download speed caps, and data transfer quotas, then hand them out to guests.
Is unifi-voucher-site free to use? What license does it have?
unifi-voucher-site is open source under the MIT license. Check the license terms before using it in commercial products.
Is unifi-voucher-site still maintained?
Actively maintained. The last commit to unifi-voucher-site was on Nov 4, 2026.
What can I use unifi-voucher-site for?
Issuing WiFi access codes to guests at cafés, hotels or co-working spaces. Letting front-desk staff print vouchers on receipt printers. Automating voucher creation from Home Assistant or other systems through the API. Offering self-service internet access in public areas with a kiosk.
How do I install unifi-voucher-site?
Set up the UniFi Hotspot Portal with voucher authentication enabled Create a docker-compose.yml from the README example and fill in your UniFi settings
Where can I get unifi-voucher-site?
The source code and installation instructions are on GitHub: https://github.com/glenndehaan/unifi-voucher-site

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects