OpenWrtHub is a self-hosted, hardware-agnostic Software-Defined Networking (SDN) controller designed specifically for OpenWrt fleets.
Built to rival commercial solutions like TP-Link Omada and Ubiquiti UniFi, OpenWrtHub transforms generic, off-the-shelf routers into a cohesive, centrally managed enterprise network.
- Zero-Touch Provisioning: Plug in a flashed OpenWrt device, and the orchestrator automatically assigns its role (Gateway/AP) and pushes the desired state via UCI commands.
- Unified Site Settings: A single pane of glass to configure VLANs, WLANs, DHCP pools, and Firewall rules across your entire fleet simultaneously.
- Resilient Edge (SD-WAN): Built-in orchestration for
mwan3. Connect multiple ISPs (LTE, Starlink, Fiber) and achieve automated sub-5-second failover. - Advanced Telemetry: Real-time L3 traffic flow mapping and historical deep packet inspection (DPI) powered by InfluxDB.
- Cryptographic Roaming: Automated deployment of 802.11r (Fast BSS Transition) for seamless Wi-Fi roaming between access points.
- Captive Portal: Forwarding Authentication Service (FAS) architecture using
openndsto generate temporary network access vouchers.
OpenWrtHub is built for high-performance edge environments:
- The Brain (Backend): Written in pure
Go, featuring a concurrent orchestration engine that pushes configurations in parallel. - The Command Center (Frontend): A sleek, dark-mode
Vue.jsdashboard for total tactical visibility. - The Memory (Databases):
PostgreSQLfor desired state and declarative config storage;InfluxDBfor time-series telemetry. - The Agents (Edge): Lightweight Lua/Shell scripts running on OpenWrt that securely phone home via WireGuard tunnels.
- Docker & Docker Compose
- OpenWrt devices (Version 22.03 or higher)
- Clone the repository:
git clone [https://github.com/tuxevil/openwrthub.git](https://github.com/tuxevil/openwrthub.git) cd openwrthub
cp .env.example .env
docker-compose up -d
The Unified Control Panel will now be available on your host.