Initial configuration
Setting up the HACS integration¶
Follow these steps to set up the HACS integration and authenticate it with GitHub.
Prerequisites¶
This guide assumes that you have completed the following steps:
- Downloaded HACS
- Restarted Home Assistant
To set up the HACS integration¶
- In Home Assistant, go to Settings > Devices & services.
-
Clear your browser cache.
- HACS won't show up in the list unless you clear your browser cache or perform a hard refresh.
-
In the bottom right corner, select + Add integration.
-
Search for HACS and select it.
-
Acknowledge the statements and select Submit.
-
Authenticate the integration:
- HACS uses a device OAuth flow for authentication with GitHub.
-
Copy the device code and select the link https://github.com/login/device.
-
Sign in to GitHub.
- If you are not signed in to GitHub in your browser, you need to sign up or sign in now to continue the setup.
-
If you are already signed in, you can skip this part.
-
Enter the device code you copied in the previous step and select Continue.
-
Select Authorize HACS.
-
Once you see the confirmation screen, you can close the tab and go back to Home Assistant.
-
Assign HACS to an area and select Finish.
8. Congrats! You have installed the HACS integration in Home Assistant.
- Now, go checkout the configuration options.
- Don't forget to setup a backup process.