The Supla is an Open Source home automation system for ESP8266 based devices. It has its own set of protocols, its own firmware and commercially available devices (produced for example by Zamel)

Currently only covers (shutters in Supla’s lingo), gates, garage doors and switches are supported, but, thanks to comprehensive and universal REST API, it’s pretty easy to add more.

Right now it’s impossible to add a device – all of them are discovered from Supla Cloud’s servers or yours. Devices disabled on Supla Cloud will not be loaded into Home Assistant.


To use Supla devices in your installation, add the following to your configuration.yaml:

    - server:
      access_token: YOUR_ACCESS_TOKEN

Configuration Variables

servers list

List of server configurations.

server string Required

Address of your Supla Cloud server (either IP or DNS name)

access_token string Required

An access token for REST API configuration. Can be acquired from http[s]:// (please add at least Channel’s Read and Action Execution permissions).