First Time Setup

First-Time Setup

This is the recommended workflow for a new or erased ESP32.

Before you start

• Wire the supported 1.29 inch CH1115 OLED to the ESP32 as described in Device and Firmware.
• Install HA Proxy Panel Manager 1.6.0.
• Keep the computer, phone, ESP32, and Home Assistant on the same local network during setup.

Flash the panel

1. Connect Home Assistant in the Manager.
2. Connect the ESP32 using the USB cable supplied with the AZ-Delivery board.
3. Open Install, select the detected serial port, and choose a clear node and friendly name.
4. Choose a saved Windows Wi-Fi profile or enter Wi-Fi manually.
5. Select temperature and humidity entities from Home Assistant. Custom entity IDs are also accepted.
6. Review the configuration, then flash. The Manager downloads and verifies the official GitHub firmware before building.

Join Wi-Fi by phone when needed

If home Wi-Fi is unavailable, the panel starts HA Proxy Panel Fallback after about 30 seconds and shows a QR code.

1. Scan the OLED QR with your phone and join the panel network.
2. Use the captive portal to select the home network and enter its password.
3. After the panel connects, reconnect the phone to the home network.

If the portal does not open automatically, browse to http://192.168.4.1. The Manager can also show the fallback QR under Overview. QR generation is offline.

Add it to Home Assistant

Leave the Manager connected while the panel joins Wi-Fi. It watches for the new node and selects it on Devices.

1. Choose Add selected to Home Assistant.
2. The Manager sends the matching API encryption key directly to Home Assistant's supported ESPHome config flow.
3. Confirm the panel appears under Settings > Devices & services > ESPHome.

To maintain the YAML in the ESPHome add-on, choose Add to Device Builder. The core ESPHome integration and ESPHome Device Builder are separate. See Home Assistant and Device Builder.