- Published on
How to Install HACS on Home Assistant OS
- Authors
- Name
- Tal
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.
- Select your User Account in the bottom left corner.
![Open User Account](/_next/image?url=%2Fstatic%2Fimages%2Fuser_login.png&w=640&q=75)
- Enable Advanced Mode in the account options.
![Open Advanced Mode](/_next/image?url=%2Fstatic%2Fimages%2Fadvanced_mode.png&w=1920&q=75)
- Now you can install the Terminal & SSH application. To do so, select Settings in the bottom left corner.
![Open Settings](/_next/image?url=%2Fstatic%2Fimages%2Fsettings.png&w=750&q=75)
- Select Add-Ons
![Open Settings](/_next/image?url=%2Fstatic%2Fimages%2Fadd_ons.png&w=1920&q=75)
- Select Add-On Store in the bottom right corner.
![Open Add On Store](/_next/image?url=%2Fstatic%2Fimages%2Fadd_on1.png&w=640&q=75)
- To begin, search for Terminal & SSH and select the Official add-on.
![Terminal & SSH Add On](/_next/image?url=%2Fstatic%2Fimages%2Fterminal_ssh.png&w=1080&q=75)
- Select the Install option.
![Install Terminal & SSH](/_next/image?url=%2Fstatic%2Fimages%2Fadd_on_store.png&w=1080&q=75)
- 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](/_next/image?url=%2Fstatic%2Fimages%2Fopen_ssh.png&w=1920&q=75)
- 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](/_next/image?url=%2Fstatic%2Fimages%2Fterminal_ui.png&w=3840&q=75)
- Paste the command below in the terminal window.
wget -O - https://get.hacs.xyz | bash -
![wget](/_next/image?url=%2Fstatic%2Fimages%2Fwget-hacs.png&w=1200&q=75)
TroubleshootingCTRL+V
not working for you?- Try
CTRL+SHIFT+V
instead - Try
SHIFT+INS(insert)
instead - Try
Right-click
instead
- Try
Having issues accessing
https://get.hacs.xyz
in the terminal?- Try it with
https://raw.githubusercontent.com/hacs/get/main/get
instead
- Try it with
- HACS will be downloaded. When it’s done downloading, run the command below to restart Home Assistant.
ha core restart
![Home Assistant Restart](/_next/image?url=%2Fstatic%2Fimages%2Fha_core_restart.png&w=1920&q=75)
- After Home Assistant reconnects, select Settings, then Devices & Services.
![Home Assistant Settings](/_next/image?url=%2Fstatic%2Fimages%2Fsettings_1.png&w=750&q=75)
![devices and Services](/_next/image?url=%2Fstatic%2Fimages%2Fdevices_services.png&w=1920&q=75)
- In the bottom right corner select add integration.
![add integration button](/_next/image?url=%2Fstatic%2Fimages%2Fadd-integration-button.png&w=640&q=75)
- Search for HACS and select it.
![HACS](/_next/image?url=%2Fstatic%2Fimages%2Fhacs_selection.png&w=1920&q=75)
- If you agree with everything, select all options and then Submit
![HACS Terms](/_next/image?url=%2Fstatic%2Fimages%2Fhacs_install.png&w=1920&q=75)
- Copy the code that Home Assistant provides and then select the link to sign into GitHub.
![Github Activation](/_next/image?url=%2Fstatic%2Fimages%2Fhacs_activation.png&w=1920&q=75)
- Sign in to GitHub, then paste in the code from the previous step.
![Github Device Activation](/_next/image?url=%2Fstatic%2Fimages%2Fgithub_activation.png&w=1920&q=75)
- Select Authorize HACS.
![Authorize HACS](/_next/image?url=%2Fstatic%2Fimages%2Fauthorize_hacs.png&w=1080&q=75)
- Congratulations HACS is now installed! you can choose an area if you like or just press finish.
![HACS Success](/_next/image?url=%2Fstatic%2Fimages%2Fhacs_success.png&w=1080&q=75)
- You should now see the HACS logo in the sidebar.
![HACS Logo](/_next/image?url=%2Fstatic%2Fimages%2FHACS_logo.png&w=750&q=75)
If the logo wasn't added to the sidebar preform a hard reset to your browser:
CTRL+F5
Windows/LinuxCMD+SHIFT+R
On Mac