--- title: "Legacy: Set Up Konnected in Home Assistant and Hass.io (0.60 or older)" description: 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 --- [Skip to content](https://support.konnected.io/legacy-set-up-konnected-in-home-assistant-and-hass.io-0.60-or-older#main-content) English Show submenu for translations [Submit a Ticket](https://support.konnected.io/kb-tickets/new?hsLang=en) [Customer portal](https://support.konnected.io/tickets-view?hsLang=en) ![Refreshed Logo Blue (HQ)](https://support.konnected.io/hs-fs/hubfs/Refreshed%20Logo%20Blue%20(HQ).png?width=250&height=45&name=Refreshed%20Logo%20Blue%20(HQ).png) - [Tickets](https://22554404.hs-sites.com/tickets-view) - [Sign out](https://22554404.hs-sites.com/_hcms/mem/logout) Open main navigation Close main navigation - [Tickets](https://22554404.hs-sites.com/tickets-view) - [Sign out](https://22554404.hs-sites.com/_hcms/mem/logout) - English Show submenu for translations - [Submit a Ticket](https://support.konnected.io/kb-tickets/new) - [Customer portal](https://support.konnected.io/tickets-view) - [Shop Now](https://konnected.io/collections/shop-now) [Shop Now](https://konnected.io/collections/shop-now) Konnected Knowledge Base - There are no suggestions because the search field is empty. 1. [Help & Support](https://support.konnected.io/?hsLang=en) 2. [Troubleshooting](https://support.konnected.io/troubleshooting?hsLang=en) 3. [Legacy: HASS Install](https://support.konnected.io/troubleshooting?hsLang=en#legacy-hass-install) # Legacy: Set Up Konnected in Home Assistant and Hass.io (0.60 or older) [Home Assistant](https://home-assistant.io/) is an open-source home automation platform that you can run yourself on a [Raspberry Pi](https://www.raspberrypi.org/) or a spare computer in your home. Home Assistant is an open-source alternative to commercial smart home hubs like SmartThings. [Hass.io](https://www.home-assistant.io/hassio) is the most popular way to install and run Home Assistant on a [Raspberry Pi.](https://amzn.to/2wFvpl7) After HASS version .60 or later we highly recommend the [Konnected Component documentation on the Home Assistant website](https://www.home-assistant.io/components/konnected/). 1. [Install Home Assistant](https://www.home-assistant.io/getting-started/) using Hass.io or any other installation method. 2. Edit your Home Assistant configuration.yml and add discovery: to enable discovery, and add a konnected section to configure your Konnected devices and the sensors attached to each zone/pin. The configuration structure looks like this: ``` # enable discovery by adding the following line discovery: konnected:   access_token: insert-a-random-string-here   devices:     - id: 6001948bcd53       binary_sensors:         - zone: 1           type: door           name: 'Front Door'         - zone: 3           type: motion           name: 'Test Motion'       switches:         - zone: out           name: siren         - zone: 5           name: 'Beep Beep'           momentary: 65           pause: 55           repeat: 4           - zone: 5           name: Warning           momentary: 65           pause: 55           repeat: -1     - id: 5ccf7f438a38       binary_sensors:         - pin: 1           type: motion           name: 'Office Motion'         - pin: 2           type: door           name: 'Office Door'         - pin: 3           type: smoke           name: Smoke Alarm           inverse: true       switches:         - pin: 5           name: 'Garage Door'           activation: low           momentary: 500         - pin: 8           name: LED Light ``` 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](https://home-assistant.io/docs/configuration/secrets) 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. Must be the full 12-character MAC address with all *lowercase* letters and numbers. You can find the MAC address 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](https://home-assistant.io/components/binary_sensor/) 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** only 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 using http (not https). For example: http://192.168.100.110:8123  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](https://support.konnected.io/connecting-to-your-network?hsLang=en) 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. ### Normally Open vs Normally Closed sensors By default, a binary sensor will report as *closed/off* when the sensor circuit is closed, and *open/on* when the sensor circuit is broken. This works for most security system sensors, but sometimes you may need to invert this logic. A common example is a normally open smoke alarm loop. Starting in Home Assistant 0.79, add **inverse: true** to the binary\_sensor device configuration to invert the on/off states. ### Momentary and Beep/Blink switches In Home Assistant version 0.77 and above, configure a momentary or beep/blink switch using the *momentary*, *pause*,and *repeat* values in each switch config. **momentary** is specified in milliseconds and defines the duration of a momentary switch actuation. **pause**is specified in milliseconds and defines the pause between momentary actuations when used with *momentary* and *repeat*. **repeat** defines the number of times to repeat the momentary pulse. For example, to make three beeps, set *repeat* to 3. Set this value to -1 for an infinitely repeating pulse until turned off. This is useful for a warning or alarm. ### 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](https://www.home-assistant.io/components/alarm_control_panel.manual/) 2. [Hass Custom Alarm](https://github.com/gazoscalvertos/Hass-Custom-Alarm) ### Known Issues and Limitations 1. Version 2.1.1 or newer of the [Konnected device software](https://github.com/konnected-io/konnected-security) is required for Home Assistant discovery to work. 2. 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 work around this. 3. May not work with SSL/TLS enabled on Home Assistant itself. Use a [reverse proxy to serve HTTPS](https://support.konnected.io/set-up-home-assistant-with-secure-remote-access-using-duckdns-and-nginx-proxy?hsLang=en) instead. ### Feedback & Questions Don't be shy if you have questions, feedback or problems. First, try posting in the [Home Assistant](https://help.konnected.io/support/discussions/forums/32000042929) forum category. You can also [contact us here](https://support.konnected.io/kb-tickets/new?hsLang=en). ### 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](https://support.konnected.io/kb-tickets/new?hsLang=en)first for guidance and ideas of what to work on. Notable contributions will be rewarded with free Konnected swag, hardware, and/or public praise! - [Konnected's Home Assistant fork](https://github.com/konnected-io/home-assistant/tree/konnected) -- active development here - [Konnected Python library](https://github.com/konnected-io/konnected-py) - [Konnected NodeMCU software](https://github.com/konnected-io/konnected-security) **Next Step:** [Set up Hass.io with secure remote access using DuckDNS and Nginx proxy](https://support.konnected.io/set-up-home-assistant-with-secure-remote-access-using-duckdns-and-nginx-proxy?hsLang=en) - [Konnected Devices in General](https://support.konnected.io/konnected-devices-in-general?hsLang=en#main-content) - [Intro to Konnected](https://support.konnected.io/konnected-devices-in-general?hsLang=en#intro-to-konnected) - [Power](https://support.konnected.io/konnected-devices-in-general?hsLang=en#power) - [WiFi and Networking](https://support.konnected.io/konnected-devices-in-general?hsLang=en#wifi-and-networking) - [Firmware and Updates](https://support.konnected.io/konnected-devices-in-general?hsLang=en#firmware-and-updates) - [Security Best Practices](https://support.konnected.io/konnected-devices-in-general?hsLang=en#security-best-practices) - [Alarm Panel](https://support.konnected.io/alarm-panel?hsLang=en#main-content) - [Installation Guide Table of Contents](https://support.konnected.io/alarm-panel?hsLang=en#installation-guide-table-of-contents) - [Wiring and Connection Guides](https://support.konnected.io/alarm-panel?hsLang=en#wiring-and-connection-guides) - [Interfacing In-parallel with a Traditional Alarm System](https://support.konnected.io/alarm-panel?hsLang=en#interfacing-in-parallel-with-a-traditional-alarm-system) - [Alarm Panel Pro](https://support.konnected.io/alarm-panel?hsLang=en#alarm-panel-pro) - [6-Zone Alarm Panel & Alarm Panel Add-on (discontinued)](https://support.konnected.io/alarm-panel?hsLang=en#6-zone-alarm-panel-alarm-panel-add-on-discontinued) - [Standalone Alarm System](https://support.konnected.io/alarm-panel?hsLang=en#standalone-alarm-system) - [GDO blaQ](https://support.konnected.io/gdo-blaq?hsLang=en#main-content) - [Getting Started with the GDO blaQ](https://support.konnected.io/gdo-blaq?hsLang=en#getting-started-with-the-gdo-blaq) - [Platform Integrations](https://support.konnected.io/gdo-blaq?hsLang=en#platform-integrations) - [Device Features](https://support.konnected.io/gdo-blaq?hsLang=en#device-features) - [GDO White](https://support.konnected.io/gdo-white?hsLang=en#main-content) - [Garage Door Opener White Installation and Setup Guide](https://support.konnected.io/gdo-white?hsLang=en#garage-door-opener-white-installation-and-setup-guide) - [Detailed Wiring Guide](https://support.konnected.io/gdo-white?hsLang=en#detailed-wiring-guide) - [Garage Door Opener v1 Installation and Setup Guide](https://support.konnected.io/gdo-white?hsLang=en#garage-door-opener-v1-installation-and-setup-guide) - [Accessories](https://support.konnected.io/accessories?hsLang=en#main-content) - [Backup Batteries](https://support.konnected.io/accessories?hsLang=en#backup-batteries) - [Sensors](https://support.konnected.io/accessories?hsLang=en#sensors) - [SmartThings](https://support.konnected.io/smartthings?hsLang=en) - [Home Assistant](https://support.konnected.io/home-assistant?hsLang=en) - [Hubitat](https://support.konnected.io/hubitat?hsLang=en#main-content) - [GDO White](https://support.konnected.io/hubitat?hsLang=en#gdo-white) - [Legacy drivers](https://support.konnected.io/hubitat?hsLang=en#legacy-drivers) - [Alarm Panels](https://support.konnected.io/hubitat?hsLang=en#alarm-panels) - [Troubleshooting](https://support.konnected.io/hubitat?hsLang=en#troubleshooting) - [Control4](https://support.konnected.io/control4?hsLang=en) - [ESPHome](https://support.konnected.io/esphome?hsLang=en#main-content) - [ESPHome](https://support.konnected.io/esphome?hsLang=en#esphome) - [Konnected Device API](https://support.konnected.io/esphome?hsLang=en#konnected-device-api) - [openHAB](https://support.konnected.io/esphome?hsLang=en#openhab) - [Matter](https://support.konnected.io/matter?hsLang=en) - [Frequently Asked Questions (FAQ)](https://support.konnected.io/frequently-asked-questions-faq?hsLang=en#main-content) - [Garage Door Opener](https://support.konnected.io/frequently-asked-questions-faq?hsLang=en#garage-door-opener) - [General](https://support.konnected.io/frequently-asked-questions-faq?hsLang=en#general) - [Pre-Purchase Guides](https://support.konnected.io/frequently-asked-questions-faq?hsLang=en#pre-purchase-guides) - [Troubleshooting](https://support.konnected.io/troubleshooting?hsLang=en#main-content) - [Hardware issues](https://support.konnected.io/troubleshooting?hsLang=en#hardware-issues) - [Frequently Asked Questions (FAQs)](https://support.konnected.io/troubleshooting?hsLang=en#frequently-asked-questions-faqs) - [Device Discovery](https://support.konnected.io/troubleshooting?hsLang=en#device-discovery) - [Konnected Device Firmware & Software](https://support.konnected.io/troubleshooting?hsLang=en#konnected-device-firmware-software) - [Legacy: HASS Install](https://support.konnected.io/troubleshooting?hsLang=en#legacy-hass-install) - [Legacy: Wiring Info](https://support.konnected.io/troubleshooting?hsLang=en#legacy-wiring-info) - [Garage Door Opener](https://support.konnected.io/troubleshooting?hsLang=en#garage-door-opener) - [Orders, Shipping & Returns](https://support.konnected.io/orders-shipping-returns?hsLang=en#main-content) - [Refund and Return Policies](https://support.konnected.io/orders-shipping-returns?hsLang=en#refund-and-return-policies) - [Shipping Information and Policies](https://support.konnected.io/orders-shipping-returns?hsLang=en#shipping-information-and-policies) - [Safety Information](https://support.konnected.io/safety-information?hsLang=en#main-content) - [Standards & Certifications](https://support.konnected.io/safety-information?hsLang=en#standards-certifications) - [Warnings & Disclosures](https://support.konnected.io/safety-information?hsLang=en#warnings-disclosures) - [Products](https://support.konnected.io/products?hsLang=en#main-content) - [Depreciated Support Articles](https://support.konnected.io/products?hsLang=en#depreciated-support-articles) - [FAQs](https://support.konnected.io/faqs?hsLang=en#main-content) - [Additional Wiring Guides](https://support.konnected.io/faqs?hsLang=en#additional-wiring-guides) - [SmartThings Steps](https://support.konnected.io/smartthings-steps?hsLang=en) - [Noonlight](https://support.konnected.io/noonlight?hsLang=en) - [Alexa](https://support.konnected.io/alexa?hsLang=en) - [Google Home](https://support.konnected.io/google-home?hsLang=en) [![Konnected](https://support.konnected.io/hubfs/konnected-logo-white.svg "Konnected")](http://konnected.io) [mailto:help@konnected.io](mailto:help@konnected.io) Copyright © 2025, Konnected Inc.