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:
- 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.
- 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.
- Install HACS:
- Open the Terminal & SSH add-on by clicking on "Open Web UI".
- This command will download and install HACS.
- Restart Home Assistant:
- Navigate to Developer Tools > Restart.
- Select "Restart Home Assistant" or reboot your device if necessary.
- 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.
- 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:
- SSH into Your Docker Host:
- Connect to your server where Home Assistant is running via SSH.
- Navigate to Home Assistant's Config Directory:
- Download HACS:
1. Run the installation script:
wget -O - https://get.hacs.xyz | bash -
- Reboot Your System or Home Assistant:
- Restart your Docker container or the entire system to ensure all changes take effect.
- 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.