Published on

How to Install HACS on Home Assistant OS

Authors
  • avatar
    Name
    Tal
    Twitter

How to Install HACS on Home Assistant – OS/Supervised

To run the command, you'll need to install the Terminal & SSH add-on. However, the option is hidden by default, so you'll need to enable it first.

  1. Select your User Account in the bottom left corner.

Open your Home Assistant instance and show your settings menu.

Open User Account
  1. Enable Advanced Mode in the account options.
Open Advanced Mode
  1. Now you can install the Terminal & SSH application. To do so, select Settings in the bottom left corner.

Open your Home Assistant instance and show your settings menu.

Open Settings
  1. Select Add-Ons
Open Settings
  1. Select Add-On Store in the bottom right corner.

Open your Home Assistant instance and show the Supervisor add-on store.

Open Add On Store
  1. To begin, search for Terminal & SSH and select the Official add-on.
Terminal & SSH Add On
  1. Select the Install option.
Install Terminal & SSH
  1. After completing the installation, click on the Start button located at the bottom left. I recommend enabling "show in sidebar" for easy access.
Terminal & SSH Options
  1. After it has started, select Open Web UI in the bottom right OR the Terminal entry that was added to the sidebar.
Terminal & SSH Sidebar
  1. Paste the command below in the terminal window.
wget -O - https://get.hacs.xyz | bash -
wget

Troubleshooting​

  • CTRL+V not working for you?

    • Try CTRL+SHIFT+V instead
    • Try SHIFT+INS(insert) instead
    • Try Right-click instead

  • Having issues accessing https://get.hacs.xyz in the terminal?

    • Try it with https://raw.githubusercontent.com/hacs/get/main/get instead
  1. HACS will be downloaded. When it’s done downloading, run the command below to restart Home Assistant.
ha core restart
Home Assistant Restart
  1. After Home Assistant reconnects, select Settings, then Devices & Services.

Open your Home Assistant instance and show your settings menu.

Home Assistant Settings

Open your Home Assistant instance and show your integrations.

devices and Services
  1. In the bottom right corner select add integration.
add integration button
  1. Search for HACS and select it.

Open your Home Assistant instance and start setting up a new integration.

HACS
  1. If you agree with everything, select all options and then Submit
HACS Terms
  1. Copy the code that Home Assistant provides and then select the link to sign into GitHub.
Github Activation
  1. Sign in to GitHub, then paste in the code from the previous step.
Github Device Activation
  1. Select Authorize HACS.
Authorize HACS
  1. Congratulations HACS is now installed! you can choose an area if you like or just press finish.
HACS Success
  1. You should now see the HACS logo in the sidebar.
HACS Logo

If the logo wasn't added to the sidebar preform a hard reset to your browser:

  • CTRL+F5  Windows/Linux
  • CMD+SHIFT+R On Mac