The essentials: i add-on essential to install on HASSIO

7 minutes of reading

Endow of a personale HUB How Home Assistant it is a particularly simple operation, especially when opting for an installation based on HASSIO (the "facilitated" version, for theappanointed). HASSIO can be installed either as a stand-alone system both as a stand-alone system virtualized on Docker.

After installing HASSIO and before provvedere in the first configuration steps, there is a short but important list of tools to implement immediately at its web frontend.

Home Assistant Official Logo

It is of simple but essential tools for management, configuration, secure connection of ours personale HUB; without it is difficult to succeed in these activities, except for the adoption of complicated workarounds that however frustrate the intrinsic simplicity of this distribution of Home Assistant.

HASSIO in fact it is a simplified version of Home Assistant - not in the functions as in the installation mode - which allows anyone to acquire this powerful HUB personnel. A Pprofoundation on the various installation alternatives is present here.

ATTENTION: Users HASSIO@Docker consider the fact that you determine add-on they activate services already present on the Docker host system (eg. SSH), therefore before activating them check that they are not already operating on the operating system.

The essentials:

Install the tools we're going to list it's rather trivial: at the frontend it is sufficient to click on the menu item "" and then "ADD-ON STORE ". It's about accessing to a real e profirst "showcase" of additional components (free) that, profirst as building blocks, they will enrich our functionalities HUB.



Maybe "Configurator"Is the most important of all add-on present on the STORE of HASSIO. It is in fact a tool that allows changing the configuration of theHUB directly from the web interface.

To install "Configurator”It is sufficient to find it in the list of add-on available at the STORE and click on "Install". Once the installation is complete, set the switches as follows and click on "Start":

HASSIO - Configurator

After closing and reopening the frontend, ticking "Show in Sidebar" will cause the Home Assistant appthe "Configurator" entry:

HASSIO - Configurator - Sidebar menu

At this point it will be possible access the configuration interface directly simply by clicking on the new item. The editor who apparirà will allow editing, creation and deletion of the folders and files necessary for the configuration of Home Assistant:

HASSIO - Configurator - Editing interface

Log Viewer

Log Viewer is a addon which adds a menu item in the sidebars and gives access to the result of the equivalent terminal command

tail -f /config/home-assistant.log

or the realtime reading of the log of Home Assistant on the screen.

HASSIO - Log Viewer - add-on

Once installed it will be possible - simply by clicking on "Log Viewer"In the front sidebar - view logs in real time. What's happening up there Home Assistant, moment by moment.

SSH Server

Sometimes it happens that it is necessary to connect al proyour system via SSH; since HASSIO mounts a particular linux version, to make it possible to connect. Again, the store HASSIO has an ad hoc component called "SSH Server"

Once installed e before starting the service you need to scroll down the page to prosee configuration, in which to indicate the user's password "root”Which will be used to connect to the system.

Under the heading "Config“In fact, there is a field in which to explicitly indicate the password:

  "authorized_keys": [],
  "password": "mia_password"

Once the password has been specified, click on "Save"And then, taking care before selecting"Start on boot","Show on sidebar" and "Protection mode"In the box at the top of the page, click on"Start"To start the service:

HASSIO - SSH Server add-on

At this point it will be possible to connect in the modes also explained in this guide or, from the web interface, by clicking on "Terminal" in the left column.

Nb La prothe cedura explained here is very elementary; the component page shows in detail how to use cryptographic keys as well.

Duck DNS

This component essentially allows to associate the proinstance Home Assistant to a FQDN (o domain, even if it is improbefore calling it that), a minimum and necessary condition to be able to control from outside the home profirst home automation. Moreover, this add-on brings in dowry automatic generation of cryptographic certificates useful for secure communication between the internet and Home Assistant in order to check remotely our personal home automation.

This FQDN, if defined with Duck DNS, is composed of the prefix (free choice, eg "casamia") and a suffix "".

Nb All the concepts related to the theme of remote control I am appromerged in detail in this other card of ours.

To install "Duck DNS”It is sufficient to find it in the list of add-on available at the STORE and click on "install"
Once the installation is complete, set the JSON payload as follows:

  "lets_encrypt": {
    "accept_terms": true,
    "certfile": "fullchain.pem",
    "keyfile": "privkey.pem"
  "token": "il-mio-token",
  "domains": [""],
  "seconds": 300


tokenThe personal token obtained through Duck DNS (to be replaced by "il-mio-token")
domainsThe FQDN of the proinstance Home Assistant (replace "casamia"With the chosen name)

To define the propri token e domain connect to the service Duck DNS and, once registered, create un profirst name (eg. "Casamia") Which will make up the FQDN, which rappwill reset your router connected to the Internet - and then the instance later Home Assistant.

Once the configuration is complete, click on "Start". From here on, the association of your internet name with the IP of your internet router will be kept automatically updated dall 'add-on:


Nb After having correctly installed and executed theadd-on Duck DNS it is not necessary (indeed, it is profirst conceptually wrong) install ad hoc components for the generation of cryptographic certificates (for example Let's Encrypt), as as previously stated the support it is already guaranteed automatically.

After it happened configuration and startup dell 'add-on, check at the bottom of the page that the certificate request was successful by clicking on "refresh"Under the heading"LOG". The procedura is completed correctly when appare the following log (it may take a few moments):

# INFO: Using main config file /data/workdir/config
+ Generating account key...
+ Registering account key with ACME server...
+ Done!
Sat Jul 20 00:36:10 CEST 2019: OK
# INFO: Using main config file /data/workdir/config
 + Creating chain cache directory /data/workdir/chains
 + Creating new directory /data/letsencrypt/ ...
 + Signing domains...
 + Generating private key...
 + Generating signing request...
 + Requesting new certificate order from CA...
 + Received 1 authorizations URLs from the CA
 + Handling authorization for
 + 1 pending challenge(s)
 + Deploying challenge tokens...
OK + Responding to challenge for authorization...
 + Challenge is valid!
 + Cleaning challenge tokens...
OK + Requesting certificate...
 + Checking certificate...
 + Done!
 + Creating fullchain.pem...
 + Done!

Nb Warning! Not profollow over without first completing this phase successfully.

Enable port forwarding on the router

To access from the external network a Home Assistant it is also necessary to configure the modem / router so that any external call to the FQDN is true to the port Home Assistant (8123, or other) be "turned" directly to the computer where it is running Home Assistant same.

We reiterate: all the concepts related to this theme of remote control I am appromerged in detail in this other card of ours.

To carry out the port forwarding configuration activity we recommend reading this guide; the necessary data appThis guide is:

  • Destination IP: Static IP of the computer where it is running Home Assistant (previously assigned);
  • External door: 8123 (unless you want to use another one, it's the same);
  • Internal door: 8123

Now, through theadd-on "Configurator", Edit the file configuration.yaml adding (taking care to replace "Casamia" with the profirst name internet - and possibly also the door “8123") The following block:


  ssl_certificate: /ssl/fullchain.pem
  ssl_key: /ssl/privkey.pem

Then save the file e restart Home Assistant.

At this point (configuration done) connecting from outside the network Wi-Fi (via browser or via theapp mobile of Home Assistant for iOS or Android) at:

(obviously replacing "Casamia"With the name previously defined) dovrebbe appto file our application for Home Assistant.

Nb. If the "External door" field has been modified by the recommended 8123 port, the address must change in relation to this change.


When you are at home - then connect to the Wi-Fi/ Home LAN - you can connect to Home Assistant without having to necessarily use external FQDN address, but directly pointing to the computer's IP address (usually the Raspberry) on which theHUB. The only necessary care will be to use the proSSL protocol.

In essence, instead of using:

You can use the address:


where obviously "IP_DEL_COMPUTER”Will be the IP address assigned to the computer and already used for portforwarding at the router.

Check Home Assistant configuration

This first, elementary tool allows the user - in the presence of an updatenamento of Home Assistant - to verify that the configuration dell 'HUB let it be approcompared to the largernamento before that it comes appsilicate.

Indeed, it often happens that he updates themnaments of Home Assistant lead proproblems with the previously working configuration given the change in functionnameof platforms, components, services and so on. "Check Home Assitant Configuration”Allows you to verify that the configuration is appropiata post updatednamento and, if it is not, of prosee the necessary corrections.

To install "Check Home Assitant Configuration”It is sufficient to find it in the list of add-on available at the STORE and click on "Install". At this point theadd-on will be operational.

In the face of notification by HASSIO of availability of a new adjournmentnamento of Home Assistant, for example:

HASSIO update

PRIMA to execute theupdate go to the page dedicated to theadd-on and click on "Start"

HASSIO - Check Home Assistant configurationAt the bottom of the page ("Log" box), press repeatedly on "refresh”Until the completion of the procedura, which will provide feedback on the correct configuration (or not) appideally used for the new version:

HASSIO - Check Home Assistant configuration - Log

any proproblems will be reported in the box. Where appfarmyard "Configuration check finished - no error found!"You can be serene on the effective, correct configuration of Home Assistant. Differently, the log will indicate what will be corrected in the configuration.

Mosquitto Broker (MQTT)

HASSIO - Mosquitto Broker

If home automation components are used with proMQTT tocollo (for example actuators / sensors Sonoff equipped with alternative firmware, type Tasmota) it is certainly useful - not to say necessary - to have an MQTT broker that serves the entire local network. Install theadd-on "Mosquitto Broker"Allows probefore obtaining this purpose.

For install and configure correctly this add-on, we recommend reading the following guide:

Configure MQTT correctly on HASSIO (version addon from v3 onwards)


HASSIO  -  Node-RED add-on

Node-RED it is not, in the immediacy of a first installation, a truly essential element but, over time, a lot proit will probably become it.

It is a applicense that allows to model logical flows and, in the domotic environment, real e propri "virtual devices"In order - often - to domotize what naturally would not be. Just take a look at projets that we have made available in inDomus.


TasmoAdmin is a very convenient tool to manage and update - simultaneously - i proprior devices with firmware Sonoff-Tasmota.

HASSIO - TasmoAdmin

Reading of theapprofondimentor on the component and our guide of use.

Home Assistant Official LogoATTENZIONE: remember that there is on our FORUM community an ad hoc section dedicated to Home Assistant, for any doubt, question, information on the specific merit of these components.

inDomus telegram channel