esphome/esphomeyaml-edge
Otto Winter 71e221f6ec
Fix
2018-12-05 21:34:24 +01:00
..
images [Huge] Util Refactor, Dashboard Improvements, Hass.io Auth API, Better Validation Errors, Conditions, Custom Platforms, Substitutions (#234) 2018-12-05 21:22:06 +01:00
rootfs [Huge] Util Refactor, Dashboard Improvements, Hass.io Auth API, Better Validation Errors, Conditions, Custom Platforms, Substitutions (#234) 2018-12-05 21:22:06 +01:00
build.json [Huge] Util Refactor, Dashboard Improvements, Hass.io Auth API, Better Validation Errors, Conditions, Custom Platforms, Substitutions (#234) 2018-12-05 21:22:06 +01:00
config.json [Huge] Util Refactor, Dashboard Improvements, Hass.io Auth API, Better Validation Errors, Conditions, Custom Platforms, Substitutions (#234) 2018-12-05 21:22:06 +01:00
Dockerfile [Huge] Util Refactor, Dashboard Improvements, Hass.io Auth API, Better Validation Errors, Conditions, Custom Platforms, Substitutions (#234) 2018-12-05 21:22:06 +01:00
icon.png Add Logo and Icon to HassIO add-on (#241) 2018-11-23 13:51:39 +01:00
logo.png [Huge] Util Refactor, Dashboard Improvements, Hass.io Auth API, Better Validation Errors, Conditions, Custom Platforms, Substitutions (#234) 2018-12-05 21:22:06 +01:00
platformio.ini HassIO add-on pre-built images 2018-06-03 19:22:25 +02:00
README.md Fix 2018-12-05 21:34:24 +01:00

Esphomeyaml Hass.io Add-On

esphomeyaml logo

GitHub stars GitHub Release Discord

About

This add-on allows you to manage and program your ESP8266 and ESP32 based microcontrollers directly through Hass.io with no programming experience required. All you need to do is write YAML configuration files; the rest (over-the-air updates, compiling) is all handled by esphomeyaml.

View the esphomeyaml documentation here

Example

With esphomeyaml, you can go from a few lines of YAML straight to a custom-made firmware. For example, to include a DHT22. temperature and humidity sensor, you just need to include 8 lines of YAML in your configuration file:

Then just click UPLOAD and the sensor will magically appear in Home Assistant:

Installation

To install this Hass.io add-on you need to add the esphomeyaml add-on repository first:

  1. Add the epshomeyaml add-ons repository to your Hass.io instance. You can do this by navigating to the "Add-on Store" tab in the Hass.io panel and then entering https://github.com/OttoWinter/esphomeyaml in the "Add new repository by URL" field.
  2. Now scroll down and select the "esphomeyaml" add-on.
  3. Press install to download the add-on and unpack it on your machine. This can take some time.
  4. Optional: If you're using SSL certificates and want to encrypt your communication to this add-on, please enter true into the ssl field and set the fullchain and certfile options accordingly.
  5. Start the add-on, check the logs of the add-on to see if everything went well.
  6. Click "OPEN WEB UI" to open the esphomeyaml dashboard. You will be asked for your Home Assistant credentials - esphomeyaml uses Hass.io's authentication system to log you in.

NOTE: Installation on RPis running in 64-bit mode is currently not possible. Please use the 32-bit variant of HassOS instead.

You can view the esphomeyaml docs here: https://esphomelib.com/esphomeyaml/index.html

Configuration

Note: Remember to restart the add-on when the configuration is changed.

Example add-on configuration:

{
  "ssl": false,
  "certfile": "fullchain.pem",
  "keyfile": "privkey.pem"
}

Option: ssl

Enables/Disables encrypted SSL (HTTPS) connections to the web server of this add-on. Set it to true to encrypt communications, false otherwise. Please note that if you set this to true you must also specify a certfile and keyfile.

Option: certfile

The certificate file to use for SSL.

Note: The file MUST be stored in /ssl/, which is the default for Hass.io

Option: keyfile

The private key file to use for SSL.

Note: The file MUST be stored in /ssl/, which is the default for Hass.io

Option: leave_front_door_open

Adding this option to the add-on configuration allows you to disable authentication by setting it to true.