2024-08-05 11:21:11 +02:00

1.9 KiB

Installing a third-party add-on repository

Home Assistant allows anyone to create an add-on repository to share their own add-ons with the community.

{% warning %} Home Assistant cannot guarantee the quality or security of third-party add-ons. Use at your own risk. {% endwarning %}

To add an add-on repository, follow these steps:

  1. Copy the URL of the repository.
    • The URL is the git repository clone URL (on GitHub, use the Code button and copy the HTTPS URL).

    • This documentation uses an example add-on repository. It is not practically useful but follows the same steps.

    • If you are interested in add-on development, refer to our add-on development documentation.

      https://github.com/home-assistant/hassio-addons-example
      
  2. Go to {% my supervisor title="Settings > Add-ons" %} and select Add-on store. Screenshot of the add-on store
  3. In the top-right corner, select the three dots {% icon "mdi:dots-vertical" %} menu, and select Repositories.
  4. Add the URL of the repository and select Add. Screenshot of the add-on store
    • Result: A new card for the repository will appear. Screenshot of the add-on store

Troubleshooting: Repository is not showing up

If you have added an add-on repository, but it's not showing up, make sure to refresh your browser. If it still doesn't show up, the add-on repository may contain invalid configuration data.

  1. Go to {% my logs title="Settings > System > Logs" %} and select Supervisor in the top right corner to get the Supervisor log.
    • It should tell you what went wrong.
  2. Report this information to the add-on repository author.