Captive Portal

The captive portal component in ESPHome is a fallback mechanism for when connecting to the configured WiFi fails.

After 1 minute of unsuccesful wifi connection attempts, the ESP will start a WiFi hotspot (with the credentials from your configuration)

../_images/captive_portal-ui.png

In this web interface, you can manually override the WiFi settings of the device (please note this will be overwritten by any subsequent upload, so make sure to also update your YAML configuration).

Additionally, you can upload a new firmware file.

When you connect to the fallback network, the web interface should open automatically (see also login to network notifications). If that does not work, you can also navigate to http://192.168.4.1/ manually in your browser.

# Example configuration entry
wifi:
  # ...
  ap:
    ssid: "Livingroom Fallback Hotspot"
    password: "W1PBGyrokfLz"

captive_portal:

No configuration variables.