Configuring HassOS

HassOS requires a bit of configuration before it's ready to be used with the Feather.

From the Home Assistant sidebar, click on Hass.io

Home Assistant uses a YAML file named configuration.yaml for each component used by Home Assistant. Previously, editing this file involved setting up SSH or SAMBA sharing on the Raspberry Pi.

We're going to use an add-on which lets us edit this file right from our browser.

From the Hass.io screen, click Add-on Store. Click Configurator.

On the configurator page, click Install. 

The installation takes a while depending on your internet speed. Once the loading circle over installs disappears, the add-on is installed.

Next up, we need to install ESPHomeYAML. Since we're using a community project, ESPHomeYAML, we'll want to add the ESPHome repository to Hass.io.

Under Repositories -> Add new repository by URL, add the ESPHome repository
https://github.com/OttoWinter/esphomeyaml

After the repository has been added, scroll down the page and click on esphomeyaml

From the esphomeyaml add-on page, click Install

Once installed, esphomeyaml should appear on the Hass.io dashboard page along with the configurator we installed earlier. 

Configuring Add-ons

While the Configurator and esphomeyaml add-ons are installed, they need some configuration. We'll start with the Configurator add on. 

From the Dashboard, click the Configurator add-on. You'll be presented with its description, some settings (such as when it updates, when it starts) and the configuration. We'll want to change the password from null to a value enclosed by quotes. 

For example, change password from:

"password": null,

to

"password": "feather",

Then, click save

Next, we'll need to add our IP address to the allowed_networks section of the configuration file. 

Under the two preconfigured IP addresses, add your computer's IP under allowed_networks enclosed in quotations. 

Then, Click Save

After you've configured both the IP and the password, click Start. A button to Open Web UI will appear when the Configurator successfully starts.

Click Open Web UI

From the new tab, enter the username and password we specified in the Config.

In the Configurator editor, make sure the file you are editing is /config/configuration.yaml.

Then, add an entry in the configuration.yaml file to enable MQTT Discovery:

Download: file
# MQTT Discovery
mqtt:
  discovery: true
  discovery_prefix: homeassistant

and Click Save.

After saving, navigate back to the Home assistant dashboard

From the sidebar, click Configuration

From Configuration, click General.

Since we changed the configuration.yaml, we'll want to validate the file to make sure nothing goes wrong when we restart Home Assistant. 

Click Check Config

If everything checks out, a message will pop up displaying Configuration valid!

After checking the configuration, we'll want to restart the server. We don't need to SSH into the Raspberry Pi and issue a restart command - Home Assistant lets us do this from within the Configuration page.

From the Configuration page, scroll down to Server Management and click Restart.

If you refresh the page, you'll encounter a Connection lost. Reconnecting... message. Since we restarted the server, it'll take a few minutes to get itself back online.

After a few minutes, refresh the page.

Once we're connected back to HassOS, we'll proceed to configuring the Feather with ESPHomeYAML.

This guide was first published on Feb 07, 2019. It was last updated on Feb 07, 2019. This page (Configuring HassOS) was last updated on Jun 26, 2019.