Open Source · ESP32 · Home Automation

Control all your ESP32 devices
from one dashboard

ESP Hub connects multiple ESP32 relay boards to a single web dashboard over WebSocket. Configure pins via a captive portal, name your switches, and control them from anywhere.

8

Relays per device

Devices per account

WS

Real-time control

MIT

Open source

Features

Everything you need to
automate your home

ESP Hub handles the hard parts — device auth, real-time sync, and state persistence — so you can focus on building.

Multi-device support

Link as many ESP32 boards as you need to a single account using a shared API key. Each board shows up independently in your dashboard.

Real-time WebSocket

Commands reach your ESP32 instantly over a persistent WebSocket connection. No polling, no delays — toggle a relay and it switches in milliseconds.

Up to 8 relays per board

Assign GPIO pins, give each relay a friendly name and icon, and control them with a single tap. Offline state syncs automatically on reconnect.

API key auth

Generate API keys from the dashboard and flash them to your ESP32 via the captive portal. Revoke a key to instantly disconnect all boards using it.

Captive portal config

First boot puts the ESP32 in AP mode. Connect to its WiFi, open the portal, enter your home network credentials and API key — done.

Self-hostable

Run ESP Hub on any VPS or home server. All you need is Node.js and a MongoDB database. The WebSocket server is a single standalone process.

How it works

Up and running in four steps

From unboxing an ESP32 to controlling your first relay takes under ten minutes.

01

Create an account

Sign up at ESP Hub and generate an API key from the dashboard. One key can be shared across multiple ESP32 boards.

02

Flash & configure

Power on your ESP32. It starts in AP mode — connect to its WiFi hotspot and open the captive portal at 192.168.4.1. Enter your home WiFi, device name, and API key.

03

Device comes online

The ESP32 reboots, connects to your home network, and opens a WebSocket connection to ESP Hub. It appears in your dashboard within seconds.

04

Configure & control

From the device detail page, assign GPIO pins to relays, name them, and start toggling them in real time from any browser.

Free & Open Source

Self-host it. Fork it.
Make it yours.

ESP Hub is MIT licensed. Run it on your own server, contribute improvements, or adapt it for your own hardware projects.