UniFi Switchboard
UniFi Switchboard is a lightweight web UI to enable and disable UniFi zone-based firewall policies from any browser on your LAN.
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
40/100 Fair
- Maintained
- 65last commit 146 days ago
- Popular
- 00 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- 502 GB minimum RAM
Availability: platform listings confirmed today, links checked 17 days ago
- GitHub stars
- 0
- Open issues
- 0
- Last commit
- 2026-06-27
- Activity
- stale
Checked 5 days ago - source: GitHub (emptyfish/unifi-switchboard)
Resources & Compatibility
Minimum requirements: 2 GB RAM.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Run the UniFi Tailscale installer Open a terminal on your UniFi console and run the installer command from the docs. It sets up Tailscale and TUN mode, a virtual network adapter that lets Tailscale route traffic between your home lab and Tailscale. source
- Check TUN mode is active Run `ip link show tailscale0` to confirm the virtual Tailscale adapter exists. If it is missing, TUN mode is not active and subnet routing or exit-node traffic will not work. source
- Share your local network subnets Run the final `tailscale up` command with `--advertise-routes` set to your local network CIDR, the address block for your home lab such as 10.0.0.0/24. Without it, devices on your Tailscale network cannot reach devices on that local network. source
- Compatibility Requires UniFi OS 3.x+ and UniFi Network app 10.1.84+. Uses the official UniFi Local API (integration/v1). source
- UniFi Requirements Requires UniFi OS 3.x+ and UniFi Network app 10.1.84+. Authenticates via the official UniFi Local API (integration/v1) using an API key; set APP_PASSWORD for login protection. source
Fetched today - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
How do I make the web UI work when running behind Cloudflare Tunnel or a reverse proxy?
Set TRUST_PROXY to true. This enables ProxyFix and the Secure cookie flag.
Where do I get the UniFi API key, and how is the web UI protected?
Generate a Local UniFi API key in Network, Integrations, API Keys. The app also requires an APP_PASSWORD of at least 8 characters for login.
Why can't I manage Guest/Hotspot or old traffic-rule firewall policies?
Guest/Hotspot zone policies are not returned by the UniFi integration API. Pre-zone-based policies have no integration API ID and cannot be toggled unless recreated as zone-based policies.
How do I point the app at a non-default UniFi site?
Set UNIFI_SITE to the UniFi site name. The default is default, so change it only if you use multiple sites or a custom site name.
What port should I map and open?
Map and open port 5055. After startup, open the host on that port to reach the app.
Answers sourced from github.com
Community
- Does anyone feel like UI is pushing the Self-Hosted controller ... - Reddit (reddit)
- Self-hosted unifi controller - security best practices - Reddit (reddit)
Collected 49 days ago - public community threads