In order to make Ariela extensible, we support 3 types of authentication to the Home Assistant server:
http apipassword (legacy support which can be removed by HA)
- permanent token (HA version >= 0.78)
- web login (HA version >= 0.78)
1.0 WiFi Name
Here you will enter
NOTE: Whenever Ariela will detect that you are connected to this network, it will going to use the internal IP address of your Home Assistant server. Also, this network name will be automatically assigned to the zone.home, so if you enable device tracker for the device, whenever you are connected to this network, Ariela will automatically inform Home Assistant that your current location is home.
In the case you are using a custom certificate like PCKS12 for security of your Home Assistant server or your server is running of NGINX, you can choose this option to import the certificate so it can be used by Ariela.
Use the “Search” option to your can inform Ariela of the certificate location and if required set the certificate password. Once these steps are completed, press the continue button. If you use a self-signed certificate, you can also skip this step, its quite possible the connection to succeed.
1.2 Internal IP
At this step, it will be required to enter the internal IP address of your Home Assistant server ( the address on your local network that can be used to access the server). This IP address will going to be used when Ariela detects that you are connected to the WiFi that you specified in the previous step. Note that if you enter an
Example of valid internal IP:
http://192.168.1.20:8123 or http://192.168.1.20 for unsecured connection
https://192.168.1.20:443 or https://192.168.1.20 for secured connection
https://192.168.1.20:MY_PORT when you have a custom port for the connection.
If everything ok then something like that should appear. If not, please check your IP address and port and try again.
1.3 External IP
This option can be skipped if you want to access your Home Assistant server only from home. Else you can specify and external IP address (eg: an address that you use to connect to your Home Assistant from a 3G/ 4G or work etc). Note that the same rules will apply regarding the port as in the case of the internal IP. Here you can also use
Here you will enter your Home Assistant credentials consisting in the username and password. If no successful message appear or you are using 2FA please use the “Web Login” option.
If everything all right, after this step a connection confirmation should appear and Ariela should be able to start.
1.5 Web Login
Use this option if the native (previous) screen of authentication fails or your Home Assistant require 2FA. Note that if 2FA or similar service is used, do not close the app using the back button. What you should do is minimize the app, enter your 2FA app to generate a code, copy the code and switch back rapid to Ariela in order to not have the code expired.
If everything works as expected a confirmation dialog will appear and you should be able to use Ariela.
If you have any issue regarding authentication, please use the contact function in order to provide information about the problem.