Page 1 of 1

Simple Runtime Wi-Fi Configuration via SoftAP and Web Server (ESP-IDF v5.5)

Posted: Tue Mar 17, 2026 5:33 pm
by Valerii62
Hi everyone,
I would like to share a small educational project I've recently finished. It demonstrates how to configure Wi-Fi credentials on an ESP32 during runtime, avoiding the need to hardcode SSID and password into the firmware.
How it works:
  1. On boot, the device checks NVS for existing Wi-Fi credentials.
  2. If credentials are missing or the connection fails, the ESP32 starts in SoftAP mode.
  3. It then launches a simple HTTP configuration server and scans for available networks.
  4. User connects to the SoftAP, selects a network via a web interface, and enters the password.
  5. The device saves the new credentials to NVS and reboots to connect in STA mode.
Key features:
  • Built with ESP-IDF v5.5 (compatible with v5.x).
  • Uses native event loop and netif handlers.
  • Clean and commented C code (main.c only for simplicity).
  • Includes a basic HTML/CSS interface for the configuration page (screenshots available in README).
I hope this example will be useful for beginners moving from Arduino to ESP-IDF who are looking for a straightforward provisioning method.
GitHub Repository: https://github.com/Valerii-Z/esp32-runt ... me-ov-file
Any feedback or suggestions are highly appreciated!
Best regards,
Valerii