Step-by-step guide on how to install HACS (Home Assistant Community Store) on your Home Assistant setup

Step-by-step guide on how to install HACS (Home Assistant Community Store) on your Home Assistant setup

Here's a step-by-step guide on how to install HACS (Home Assistant Community Store) on your Home Assistant setup:
Prerequisites:

  • Home Assistant: Ensure you are running Home Assistant version 0.92 or later.
  • GitHub Account: You need a GitHub account to authenticate HACS.

Installation Steps:

For Home Assistant OS / Supervised:

  1. Enable Advanced Mode:
    • Go to your user profile in Home Assistant by clicking on your username in the sidebar.
    • Enable "Advanced Mode." This might be necessary to see some add-ons in the store.
  2. Install Terminal & SSH Add-on (If not using Docker):
    • Navigate to Settings > Add-ons > Add-on store.
    • Search for "Terminal & SSH" and install it.
    • Start the add-on once installed.
  3. Install HACS:
    • Open the Terminal & SSH add-on by clicking on "Open Web UI".
    • This command will download and install HACS.
  4. Restart Home Assistant:
    • Navigate to Developer Tools > Restart.
    • Select "Restart Home Assistant" or reboot your device if necessary.
  5. Setup HACS Integration:
    • Go to Settings > Devices & Services > Add Integration.
    • Search for "HACS" and click on it.
    • Agree to the terms by checking the boxes and click "Submit".
    • You'll need to authorize HACS with your GitHub account by entering the code provided in Home Assistant into your GitHub account's authorization page.
  6. Finish Setup:
    • Once authorized, you should see HACS in the sidebar of Home Assistant.

In the terminal, run:

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

For Docker Installations:

  1. SSH into Your Docker Host:
    • Connect to your server where Home Assistant is running via SSH.
  2. Navigate to Home Assistant's Config Directory:
  3. Download HACS:
    1. Run the installation script:
wget -O - https://get.hacs.xyz | bash -
  1. Reboot Your System or Home Assistant:
    • Restart your Docker container or the entire system to ensure all changes take effect.
  2. Add HACS Integration:
    • After reboot, log back into Home Assistant.
    • Follow steps similar to step 5 above under the OS/Supervised instructions to add the HACS integration.

Post Installation:

  • Explore HACS: Now you can use HACS to install custom integrations, themes, and other add-ons. Navigate to the HACS menu in Home Assistant to start browsing or searching for add-ons.
  • Backup: Always ensure you back up your Home Assistant configuration before and after adding new integrations through HACS.

Notes:

  • Stability: Remember, integrations from HACS are third-party and might impact stability. Always review what you're installing.
  • Updates: Check HACS regularly for updates to keep your custom integrations up-to-date.

This guide should help you set up HACS on your Home Assistant system, enhancing its functionality with community-driven add-ons.