Install and Configure Integrations

Use this guide to install integrations in your Home Assistant instance.

There are two main integration routes:

• Direct Home Assistant integration.
• HACS-first integration.

Direct Home Assistant Integration Route

Use this route when the integration can be installed directly from the native Home Assistant integration catalog.

1. In Home Assistant, go to Settings > Devices & Services > Add Integration.
2. Search for the integration you want to install.
3. Open the integration and start the setup flow.
4. Enter any required information, such as credentials, IP addresses, or device details.
5. Complete any approval, MFA, or account-login steps if required.
6. Finish the setup flow and confirm the integration appears correctly in Home Assistant.

HACS-First Integration Route

Use this route when the integration must be installed through HACS before it can be added in Home Assistant.

1. Install HACS if it is not already installed.
2. Open HACS in Home Assistant.
3. If the integration is already available in HACS, search for it and install it.
4. If it is not already available, add the repository as a custom repository in HACS using the menu in the upper right-hand corner.
5. Install the integration through HACS.
6. Restart Home Assistant if the integration requires a restart.
7. After the HACS install is complete, go to Settings > Devices & Services > Add Integration.
8. Search for the newly installed integration and complete the setup flow.
9. Finish any approval, MFA, account-login, or device-discovery steps that the integration requires.

Further Reading