Skip to content
English
  • There are no suggestions because the search field is empty.

Connecting to WiFi using a Web Browser (Captive Portal)

Use the built-in WiFi setup page to connect the Konnected device to WiFi.

Connect your device to WiFi with only a web browser (no app download needed) by following these simple steps.

This article applies to all Konnected devices running the ESPHome firmware platform with WiFi enabled.

When you first plug in your Konnected device, it will broadcast a WiFi setup network or "captive portal" named konnected-xxxxxx (where xxxxxx is the last 6 characters of the device ID). The captive portal provides a web interface to configure WiFi for the first time.

  1. Power on the Konnected device and situate yourself within 10ft (3m) of the device.
  2. Connect your computer or mobile device to the konnected-xxxxxx WiFi setup network broadcast by the device.

    Screenshot 2025-09-23 at 9.17.35 AM
  3. Once connected, open a web browser and navigate to http://192.168.4.1. This is the IP address of the Captive Portal WiFi setup page.
  4. Find your WiFi network and click it, or manually enter your WiFi SSID and password in the fields below.

    Screenshot 2025-09-23 at 9.19.22 AM
  5. Click or tap Save to send the WiFi credentials to the device.
  6. If the connection is successful, the setup network will disappear and your computer or mobile device will disconnect and automatically re-connect to your home network.
  7. Proceed with discovering the Konnected device in the Konnected mobile app or your smart home platform.

Disabling the Captive Portal

Captive Portal can be disabled in the firmware settings as a security measure to prevent unauthorized persons from changing the WiFi network of the device. To disable the captive portal, your preferred WiFi credentials must be embedded in the firmware configuration.

When Captive Portal is disabled, the device will not broadcast a WiFi setup network.