UniFi Switchboard

UniFi Switchboard is a lightweight web UI to enable and disable UniFi zone-based firewall policies from any browser on your LAN.

  • Network Services
  • Productivity
  • Security
  • Tools & Utilities
UniFi Switchboard is a lightweight web UI to enable and disable UniFi zone-based firewall policies from any browser on your LAN. Authenticates via the official UniFi Local API using an API key — no username or password required. Log in with your APP_PASSWORD and toggle your custom rules on or off instantly.

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

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

Collected 49 days ago - public community threads