Skip to content

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:

To set up the HACS integration

  1. In Home Assistant, go to Settings > Devices & services.
  2. Clear your browser cache.

    • HACS won't show up in the list unless you clear your browser cache or perform a hard-refresh.
  3. In the bottom right corner, select + Add integration.

    image image

  4. Search for HACS and select it.

    image image

  5. Acknowledge the statements and select Submit.

    image image

  6. 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.

      image image

    • 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.

        image image

    • Enter the device code you copied in the previous step and select Continue.

      image image

    • Select Authorize HACS.

      image image

    • Once you see the confirmation screen, you can close the tab and go back to Home Assistant.

      image image

  7. Assign HACS to an area and select Finish.

    image image 8. Congrats! You have installed the HACS integration in Home Assistant.