Set Up Konnected in Home Assistant and

Home Assistant is an open-source home automation platform that you can run yourself on a Raspberry Pi or a spare computer in your home. Home Assistant is an open-source alternative to commercial smart home hubs like SmartThings. is the most popular way to install and run Home Assistant on a Raspberry Pi.

 Now Supported in Home Assistant 0.70 and newer!

Konnected support is now built-in to Home Assistant and starting with release 0.70. This release is currently in beta with a scheduled release date of May 25.

  1. Install Home Assistant using or any other installation method. Make sure you're running version 0.70 or newer. 
  2. Edit your Home Assistant configuration.yml and add a konnected section to configure your Konnected devices and the sensors attached to each zone/pin. The configuration structure looks like this:
      access_token: insert-a-random-string-here
        - id: 8bcd53
            - zone: 1
              type: door
              name: 'Front Door'
            - zone: 3
              type: motion
              name: 'Test Motion'
            - zone: out
              name: siren
        - id: 438a38
            - pin: 1
              type: motion
              name: 'Office Motion'
            - pin: 2
              type: door
              name: 'Office Door'
            - pin: 5
              name: 'Garage Door'
              activation: low   

    The access_token key can be any random string. This is used to ensure that only those devices which you have configured can authenticate to Home Assistant to change a device state. For security, we recommend using secrets.yaml to specify this.

    The devices key under the konnected section represents a list of Konnected devices that you have on your network. Each NodeMCU WiFi module is considered a device.

    The device id is based on the MAC address of the WiFi module with colons/punctuation removed. You can either use the full 12-character (3 byte) MAC address, or just the last 6 characters for brevity. You can find the MAC address when you connect the device to WiFi it's part of the SSID broadcast, or by looking in your router's listing of devices connected to your WiFi.

    Nested under the devices list should be a section for binary_sensors and optionally switches. 

    For binary_sensors, use zone (for the Konnected branded Alarm Panel hardware) or pin (for the generic NodeMCU pinout) to specify the sensors connected to each zone/pin. Do NOT use both zone and pin in the same device configuration. Type can be any of the Binary Sensor types built in to Home Assistant. Name is a descriptive name that you choose that represents your device. Sensors can be attached to zones 1 - 6 on the Konnected branded hardware which correspond to pins D1, D2, D5, D6, D7 and RX respectively on the generic NodeMCU breakout board. Note that when specifying pins, use only the digit. Pin RX is represented as 9.

    For switches, use zone or pin similarly to specify the device connected to each. In the case of actuators, a type is not needed, it will show up as a generic on/off switch in Home Assistant. You can also specify an activation key which can be either "low" or "high" (or 0 or 1) to specify the activation state of the attached device (default is high). On the Konnected branded boards, use zone: out to represent the dedicated siren output or OUT terminal. On the generic NodeMCU board, pins D1, D2, D5, D6, D7 and D8 are usable as actuators. 

    Set api_host (new in Hass 0.72) if you've also set base_url in your Hass configuration to an external facing hostname. This should be set to the internal host or IP address & port of Home Assistant. For example:
     This ensures that Konnected talks to Hass exclusively over your local LAN and isn't dependent on DNS or the internet.

  3. Ensure that your Konnected devices are connected to your WiFi network and restart Home Assistant. Within a minute or two Home Assistant should discover your devices on the network and automatically sync your configuration settings from Home Assistant to the Konnected device. Your configured sensors should appear automatically on the Home Assistant dashboard. After the initial sync, the Konnected device will instantly update Home Assistant any time the sensor status changes!

Configuring Home Assistant as an alarm system

Now that you've got your sensors and siren talking to Home Assistant, there are a few ways to use it as an alarm system.

  1. Manual Alarm Control Panel
  2. Hass Custom Alarm

Known Issues and Limitations 

  1. Version 2.1.1 or newer of the Konnected device software is required for Home Assistant discovery to work.
  2. The momentary switch and beep/blink capabilities are not yet supported
  3. Temperature and humidity sensors are not yet supported
  4. If base_url is set in your Hass configuration, this address must be accessible internally as well because Konnected will use this host to communicate with Hass. In Hass 0.72 an api_host configuration option was added to avoid this.
  5. May not work with SSL/TLS enabled. Workaround: Use a reverse proxy for SSL/TLS termination like HAProxy or Nginx and configure Konnected to talk to Hass over the local LAN.

Feedback & Questions

Don't be shy if you have questions, feedback or problems. First, try posting in the Home Assistant forum category. You can also contact us here.

Open Source Contributions

We welcome open source contributions from developers like you! If you're interested in helping with the Konnected Home Assistant integration, feel free to dive into the code and submit a pull request or contact us first for guidance and ideas of what to work on. Notable contributions will be rewarded with free Konnected swag, hardware, and/or public praise!

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.