UniFi Voucher Site
Web app to create, print, email, and manage UniFi guest vouchers with OIDC support, kiosk mode, PDF/thermal printing, and a REST API. Deployable via Docker.
UniFi Voucher Site is a web-based application for creating and managing guest vouchers for UniFi-managed networks. It integrates with UniFi OS/Network via the integrations API to create, list, and revoke vouchers through a web UI or programmatic API.
Key Features
- Create, view, and manage UniFi guest vouchers with customizable expiration, data limits, speeds, and single/multi-use types
- Web UI and REST API for administration and automation
- OpenID Connect (OIDC) support for SSO and scoped visibility by email domain
- Kiosk mode for public voucher generation with optional name requirement and timeout
- PDF generation and support for ESC/POS thermal printers for single and bulk voucher printing
- Email distribution of vouchers via SMTP with localized email/print templates and QR "scan to connect" codes
- Docker-friendly deployment with environment variables or options.json configuration and Home Assistant add-on
- Optional automated cleanup tasks to remove expired or unused vouchers
Use Cases
- Small businesses, cafes, or event venues issuing time- or data-limited guest WiFi access codes
- Reception or self-service kiosks where visitors generate vouchers without staff intervention
- Home or small-office automation integrating voucher issuance with Home Assistant or other systems via the API
Limitations and Considerations
- Requires a UniFi OS v4.2.8+ and UniFi Network v9.1.119+ environment and a UniFi Integration API key; compatibility with legacy UniFi Network Server is limited
- Relies on the UniFi controller API for voucher lifecycle; behavior and available features depend on the UniFi firmware/API version
- No embedded database; application state and voucher records are managed through UniFi and configuration files
UniFi Voucher Site provides a focused, deployable solution to manage guest WiFi vouchers for UniFi environments, emphasizing ease of deployment, printing options, and authentication integration. It is suitable for admins who need a lightweight, extensible voucher portal that integrates with existing UniFi infrastructure.
