# UniFi Switchboard

UniFi Switchboard is a lightweight web UI to enable and disable UniFi zone-based firewall policies from any browser on your LAN. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/3427/unifi-switchboard

## Description

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.

## Health score

40/100 (Fair), based on 4 of 4 factors.
- Maintained: 65 (last commit 146 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 50 (2 GB minimum RAM)

## Links

- Unraid: https://ca.unraid.net/apps/unifi-switchboard-17ylgfn0nvij5j?q=unifi-switchboard
- GitHub: https://github.com/emptyfish/unifi-switchboard

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/3427/unifi-switchboard), the self-hosted and open-source app directory.
