How to Install HACS on Home Assistant

Today we’re going to take a look at how to install HACS on Home Assistant.

HACS stands for Home Assistant Community Store and is a tool that allows you to customize Home Assistant by downloading different integrations and themes. Following this process will allow you to create a fully customized dashboard with one of the many different Home Assistant themes that currently exist, as well as customize Home Assistant in other ways too.

The process is slightly different for the OS/Supervised version of Home Assistant than it is for the Docker container, but we’ll take a look at both options below. Fortunately, you only really need to run one command which will download all of the necessary files.

If you’d like to know how to install HACS on Home Assistant using Docker, please scroll down to the second heading.

How to Install HACS on Home Assistant – OS/Supervised

Since the command has to be run from the terminal, we need to install the Terminal & SSH add-on. However, we need to actually enable the option first (it will be hidden in the add-on store by default).

1. Select your User Account in the bottom left.

image 10

2. Enable Advanced Mode in the account options.

image 11

3. Now that Advanced Mode is enabled, we can install the Terminal & SSH application. Select Settings in the bottom left.

image 7

4. Select Add-ons.

image 8

3. In the bottom right, select Add-On Store.

image 9

4. Search for Terminal & SSH, then select the Official add-on.

image 12

5. Select the Install option.

image 13

6. When it’s done installing, select Start in the bottom left. You can also enable any of the other options that you’d like.

image 14

7. After it’s started, select Open Web UI in the bottom right.

image 15

8. Paste the command below in the terminal window by pressing CTRL + SHIFT + V. If you have trouble pasting it in, type the command into the terminal window and press enter.

wget -O - https://get.hacs.xyz | bash -
image 17

9. HACS will be downloaded. When it’s done downloading, run the command below to restart Home Assistant.

ha ha restart
image 19

10. After Home Assistant connects, select Settings, then Devices & Services.

image 20

11. In the bottom right, select Add Integration.

image 21

12. Search for HACS and select it.

how to install hacs on home assistant

13. If you agree with everything, select all options and then Submit.

image 23

14. Copy the code that Home Assistant provides and then select the link to sign into GitHub.

hacs

15. Sign in to GitHub, then paste in the code from the previous step.

image 25

16. If you’d like to proceed, select Authorize HACS.

hacs2

17. HACS is now installed! It’s best to reboot now by selecting Settings > System > Hardware > Reboot Host (top right corner).

image 26

18. After Home Assistant loads back up, HACS will be fully installed and ready to use!

image 27

How to Install HACS on Home Assistant – Docker

The option above looked at how to install HACS on Home Assistant using the OS/Supervised version, however, you can easily install it on Docker as well.

The main difference is that instead of installing the Terminal & SSH application, you’ll have to access the terminal on your Docker host and navigate to the folder location where the /config volume is mounted. In the example below, it’s mounted in the /home/frank/docker/home-assistant directory.

1. SSH into your Docker host and navigate to the folder location where you have the Home Assistant /config volume.

2. Run the command below.

wget -O - https://get.hacs.xyz | bash -
image 28

3. The files will now be downloaded and put into the directory where your Home Assistant volume is mapped.

image 29

4. Reboot your Docker host. Please keep in mind that any containers running on this machine will temporarily stop during the reboot.

sudo reboot now
image 30

5. Log in to Home Assistant.

image 31

6. After Home Assistant connects, select Settings, then Devices & Services.

image 20

7. In the bottom right, select Add Integration.

image 21

8. Search for HACS and select it.

image 22

9. If you agree with everything, select all options and then Submit.

image 23

10. Copy the code that Home Assistant provides and then select the link to sign into GitHub.

hacs

11. Sign in to GitHub, and then paste in the code from the previous step.

image 25

12. If you’d like to proceed, select Authorize HACS.

hacs2

13. HACS is now installed! It’s best to reboot your Docker host at this point.

sudo reboot now
image 30

14. After Home Assistant loads back up, HACS will be fully configured and ready to use!

image 27

Conclusion

This tutorial looked at how to install HACS on Home Assistant. HACS is incredibly powerful and gives you loads of different options for customizing Home Assistant.

Thanks for checking out the tutorial on how to install HACS on Home Assistant. If you have any questions on how to install HACS on Home Assistant, please leave them in the comments!

Please share if this helped you!

This Post Has 4 Comments

  1. Stu Megson

    Thank you for sharing, an up to date version. And this works well.
    Great job.
    We need more new up to date help files.

    1. WunderTech

      I’m glad that it helped, thanks for checking out the tutorial!!

  2. James

    Thanks for such a great writeup as always!

    For anyone running Home Assistant in a Docker on Synology, you may find the following steps useful as Synology use 7Zip instead of unzip, which will cause issues. These steps replace steps 1, 2 and 4 in the “How to Install HACS on Home Assistant – Docker” section.

    1. SSH into your Synology box then connect to the Docker container with the following command (replace homeassistant with the name of your Home Assistant container): sudo docker exec -it homeassistant bash

    2. Download HACS: wget -O – https://get.hacs.xyz | bash –

    3. Reboot the Home Assistant container: reboot now

    I hope that helps 🙂

    James

    1. WunderTech

      Awesome info, thank you very much for sharing!!

Comments are closed.