UniFi-Voucher-Site

UniFi-Voucher-Site

Docker app from grtgbln's Repository

Overview

UniFi Voucher Site is a web-based platform for generating and managing UniFi network guest vouchers.

Requirements


        Can be configured via an `options.json` file or via environmental variables.
    

Runtime arguments

Web UI
http://[IP]:[PORT:3000]/
Network
bridge
Privileged
false

Template configuration

Web UI PortPorttcp

Container Port: 3000

Target
3000
Default
3000
Value
3000
Config FilePath

Config file. Remove to use environmental variables instead.

Target
/data/options.json
Default
/mnt/user/appdata/unifi_voucher_site/options.json
Value
/mnt/user/appdata/unifi_voucher_site/options.json
UniFi OS Console - IP AddressVariable

IP address of the UniFi OS Console

Target
UNIFI_IP
UniFi OS Console - PortVariable

Port of the UniFi OS Console

Target
UNIFI_PORT
Default
443
Value
443
UniFi OS Console - TokenVariable

The API Key created on the integrations tab within UniFi OS

Target
UNIFI_TOKEN
UniFi OS Console - Site IDVariable

Site ID for the UniFi OS Console

Target
UNIFI_SITE_ID
Default
default
Value
default
UniFi OS Console - SSIDVariable

The UniFi SSID where guests need to connect to (Used within templating and 'Scan to Connect')

Target
UNIFI_SSID
UniFi OS Console - SSID PasswordVariable

The UniFi SSID WPA/WPA2/WPA3 Password (Can be ignored for 'Open' networks) (Used within templating and 'Scan to Connect')

Target
UNIFI_SSID_PASSWORD
Authentication - Web UI - EnableVariable

Enable internal authentication for the voucher portal web UI

Target
AUTH_INTERNAL_ENABLED
Default
true|false
Authentication - Web UI - PasswordVariable

Password for internal authentication for the voucher portal web UI

Target
AUTH_INTERNAL_PASSWORD
Authentication - OIDC - EnableVariable

Enable OpenID Connect authentication for the voucher portal web UI

Target
AUTH_OIDC_ENABLED
Default
false|true
Authentication - OIDC - Issuer Base URLVariable

OIDC issuer base url provided by oauth provider. Example: https://auth.example.com/.well-known/openid-configuration

Target
AUTH_OIDC_ISSUER_BASE_URL
Authentication - OIDC - App Base URLVariable

OIDC UniFi Voucher base url (This application). Example: https://voucher.example.com

Target
AUTH_OIDC_APP_BASE_URL
Authentication - OIDC - Client IDVariable

OIDC client id provided by oauth provider

Target
AUTH_OIDC_CLIENT_ID
Authentication - OIDC - Client SecretVariable

OIDC client secret provided by oauth provider

Target
AUTH_OIDC_CLIENT_SECRET
Authentication - API - Bearer TokenVariable

The bearer token used for the API

Target
AUTH_INTERNAL_BEARER_TOKEN
Authentication - Limit Admins to Own OrganizationVariable

Limit voucher administrators to managing only vouchers associated with their own organization. If enabled, system automatically assigns the administrator’s email domain as a note to each created voucher.

Target
PIN_OIDC_USER_TO_OWN_DOMAIN
Default
false|true
Voucher TypesVariable

A semi-colon-separated list of voucher types in the following format: expiration in minutes (required),single-use or multi-use vouchers value - '0' is for multi-use (unlimited) - '1' is for single-use - 'N' is for multi-use (Nx) (optional),upload speed limit in kbps (optional),download speed limit in kbps (optional),data transfer limit in MB (optional)

Target
VOUCHER_TYPES
Default
480,1,,,;
Value
480,1,,,;
Allow Custom Voucher TypesVariable

Allow users to create custom vouchers types within the UI

Target
VOUCHER_CUSTOM
Default
false|true
PrintersVariable

A comma-separated list of printer formats and IPs. Example: 'pdf,192.168.1.10'

Target
PRINTERS
Email - From AddressVariable

The email address that will be used as the sender of the emails

Target
SMTP_FROM
Email - SMTP HostVariable

The SMTP host to use for sending emails

Target
SMTP_HOST
Email - SMTP PortVariable

The SMTP port to use for sending emails

Target
SMTP_PORT
Default
587
Value
587
Email - Use TLSVariable

Use TLS for the SMTP connection

Target
SMTP_SECURE
Default
false|true
Email - SMTP UsernameVariable

The SMTP username to use for sending emails

Target
SMTP_USERNAME
Email - SMTP PasswordVariable

The SMTP password to use for sending emails

Target
SMTP_PASSWORD
Kiosk - EnableVariable

Enable/disable the kiosk page on /kiosk

Target
KIOSK_ENABLED
Default
false|true
Kiosk - Voucher TypesVariable

A semi-colon-separated list of voucher types in the following format: expiration in minutes (required),single-use or multi-use vouchers value - '0' is for multi-use (unlimited) - '1' is for single-use - 'N' is for multi-use (Nx) (optional),upload speed limit in kbps (optional),download speed limit in kbps (optional),data transfer limit in MB (optional)

Target
KIOSK_VOUCHER_TYPES
Default
480,1,,,;
Value
480,1,,,;
Kiosk - Guest Name RequiredVariable

Require the guest to enter their name on the kiosk page

Target
KIOSK_NAME_REQUIRED
Default
false|true
Kiosk - TimeoutVariable

Sets the Kiosk timeout in seconds (Returns the user back to the starting page after inactivity)

Target
KIOSK_TIMEOUT
Default
60
Value
60
Kiosk - HomepageVariable

Enable/disable an override to redirect to the Kiosk on the / url (Also enables a link from the Kiosk back to the Admin UI)

Target
KIOSK_HOMEPAGE
Default
false|true
Kiosk - EmailVariable

Enable/disable the email voucher button (Requires SMTP to be setup)

Target
KIOSK_EMAIL
Default
false|true
Kiosk - Printer IPVariable

Enable a printer for Kiosk Vouchers (this automatically prints vouchers), e.g. an ESC/POS-compatible printer

Target
KIOSK_PRINTER
Tasks - Cleanup Expired VouchersVariable

Enable/disable automatic cleanup of expired vouchers

Target
TASK_CLEANUP_EXPIRED
Default
false|true
Tasks - Cleanup Unused VouchersVariable

Enable/disable automatic cleanup of unused (> 1 day) vouchers

Target
TASK_CLEANUP_UNUSED
Default
false|true
Log LevelVariable

Log level for the application

Target
LOG_LEVEL
Default
info|error|debug
Authentication - DisableVariable

Disable all authentication methods

Target
AUTH_DISABLE
Default
false|true
Enable Web UIVariable

Enable the web UI

Target
SERVICE_WEB
Default
true|false
Enable APIVariable

Enable the API

Target
SERVICE_API
Default
true|false
Translation - Default LanguageVariable

Sets the default translation for dropdowns

Target
TRANSLATION_DEFAULT
Default
en
Value
en
Translation - Hidden LanguagesVariable

A comma-separated list of language codes to hide from the language selection dropdown

Target
TRANSLATION_HIDDEN_LANGUAGES
Translation - DebugVariable

Enables/disables translation debugging, when enabled only translation keys are shown

Target
TRANSLATION_DEBUG
Default
false|true

Download Statistics

39,225
Total Downloads
4,608
This Month
3,068
Avg / Month

Total Downloads Over Time

Loading chart...

Details

Repository
glenndehaan/unifi-voucher-site:latest
Last Updated2026-04-13
First Seen2025-04-25

Run UniFi-Voucher-Site on Unraid.

UniFi-Voucher-Site is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.