There are two Residence Assistant variations which you could set up on an everyday Linux distro. You’ll be able to both set up the supervised model or select the non-supervised model of Residence Assistant, based mostly in your necessities and expertise with Linux.
Whereas non-supervised set up is fast and simple, the supervised model requires a number of further steps. However if you wish to expertise the total energy of Residence Assistant on Ubuntu or Debian, you could go for the supervised model. Let’s examine how one can arrange a Supervised Residence Assistant server on Ubuntu.
Set up Supervised Residence Assistant on Ubuntu/Debian
To put in and arrange Residence Assistant Supervised, you first want to put in Ubuntu in your laptop. You should use an previous PC or ideally a laptop computer because it consumes quite a bit much less energy.
We suggest you put in Ubuntu Server because it’s way more light-weight than Ubuntu Desktop. As soon as Ubuntu is put in, observe the beneath steps to put in and configure Residence Assistant Supervised.
That is a complicated methodology for putting in Residence Assistant Supervised on an everyday Linux OS. In case you are not a complicated consumer or somebody not accustomed to Linux, it is best to keep away from this because it requires expertise with Linux, Docker, containers, and networking. However you are free to experiment, after all.
Step 1: Set up Docker on Ubuntu
First, examine for and apply updates to Ubuntu Server utilizing the next command:
sudo apt replace && sudo apt improve -y
Then set up and arrange Docker on Ubuntu. You might also set up Portainer to handle and set up containers.
Ensure that to put in Ubuntu Server 20.04.5 LTS and Docker CE >= 20.10.17.
Step 2: Set up Supervised Residence Assistant on Ubuntu Utilizing Docker
Entry the Ubuntu terminal over SSH and run the next instructions as root to put in the Residence Assistant container:
sudo docker run -d --name=homeassistant --restart=all the time --network=host -v /and so on/homeassistant:/config homeassistant/home-assistant:steady
Subsequent, copy and paste the beneath command to put in the dependencies:
sudo apt set up apparmor jq wget curl udisks2 libglib2.0-bin network-manager dbus lsb-release systemd-journal-remote -y
Set up Docker-CE by working:
curl -fsSL get.docker.com | sh
Obtain the most recent OS-Agent from the GitHub web page utilizing the beneath command (the x86_64.deb package deal):
wget https://github.com/home-assistant/os-agent/releases/obtain/1.4.1/os-agent_1.4.1_linux_x86_64.deb
Set up the downloaded DEB package deal utilizing dpkg by working:
sudo dpkg -i os-agent_*.deb
Substitute the package deal identify within the instructions above with the most recent package deal identify.
Test if the set up was profitable with:
gdbus introspect --system --dest io.hass.os --object-path /io/hass/os
You need to see Interface particulars within the output as proven beneath:
If the gdbus command just isn’t acknowledged, set up libglib2.0-bin utilizing APT to make it work.
Lastly, run the next command to put in the Supervised Residence Assistant Debian package deal in your Ubuntu machine:
wget https://github.com/home-assistant/supervised-installer/releases/newest/obtain/homeassistant-supervised.deb
Subsequent, run:
sudo dpkg -i homeassistant-supervised.deb
This received’t take a lot time to finish. After the set up, you possibly can open Portainer to examine the put in containers.
You may also go to the IP of the Ubuntu machine at port 8123 to entry Supervised Residence Assistant. You could find the IP tackle utilizing the ifconfig command.
As an illustration, let’s think about this because the IP tackle:
192.168.0.111:8123
This could load the Residence Assistant setup display the place you possibly can create a consumer account and end the preliminary setup. In case you have a backup out of your earlier Residence Assistant occasion, you may additionally restore it from the setup display.
You may also entry Residence Assistant utilizing the next URL on an area community:
http://homeassistant.native:8123/
After getting arrange Residence Assistant, you possibly can set up the add-ons and create backups with a number of clicks. You may also expose your Residence Assistant server to the web with a safe HTTPS connection for distant entry utilizing the Cloudflare tunnel.
Troubleshooting Residence Assistant Errors on Linux
Residence Assistant Supervised will work on any x86 or x64 {hardware} that may run Ubuntu or Debian. It really works the identical as on Raspberry Pi {hardware} with Residence Assistant Working System. Nevertheless, you could expertise some points and obtain warnings whereas utilizing it.
Whilst you can ignore some warnings, you could want to repair the errors to put in the add-ons and Residence Assistant Core system updates. Under we have now addressed these points with their options and workarounds.
1. Can’t Set up or Replace Add-Ons or HA Core
Chances are you’ll encounter an error whereas putting in or updating the add-ons or the Residence Assistant Core updates. To repair this, first, cease the Portainer container with:
sudo docker cease portainer
Restart the Residence Assistant Supervisor utilizing the next command:
sudo docker restart hassio_supervisor
Now you possibly can open Residence Assistant and go to Settings to put in and replace add-ons or Residence Assistant Core updates with none error message.
2. Residence Assistant Displaying A number of Repairs
Residence Assistant can show points underneath the Restore part that you could repair to make sure your good gadgets are related and dealing as meant. Nevertheless, with Supervised Residence Assistant set up, you might even see a number of suggestions to restore or repair Residence Assistant.
You’ll be able to ignore the restore strategies that present the next:
- Unsupported system – Working System
- Unsupported system – Unsupported software program
- Unsupported system – Connectivity examine disabled
- Unsupported system – Systemd Journal points
These might look intimidating however relaxation assured that they don’t influence Supervised Residence Assistant or its elements in any method.
In case you see “Unhealthy system – Docker misconfigured” underneath the Repairs part, run the next command to restart Docker:
docker begin container_name
Expertise the Energy of Supervised Residence Assistant on Ubuntu
Residence Assistant is designed and developed to work with the Residence Assistant Working System (HassOS). Whilst you can set up non-supervised Residence Assistant on an everyday Linux OS comparable to Debian or Ubuntu fairly simply, you received’t have the ability to set up add-ons or use the backup service.
In Non-Supervised Residence Assistant, it is advisable set up and configure the add-ons manually, create backups, make repairs, reset settings, and so on. Nevertheless, you are able to do all of the above in a number of clicks on Residence Assistant Supervised.
