Skip to content

Update HACS

As soon as a new version of HACS is available, you'll receive an update notification in Home Assistant, just like with any other integration.

Updating HACS

Follow these steps to update HACS itself. Updating HACS does not automatically update the repositories you have downloaded from HACS.

  1. Create a backup and download that backup to another device.
  2. In Home Assistant, go to Settings > Updates.
    • Select the HACS update notification and check the release notes for backward-incompatible changes.
    • If you're sure you want to update, select Install.
  3. Restart Home Assistant.

Updating repositories

Each repository represents an independent open-source project maintained by someone from the community. Each repository therefore has its very own update cycle. HACS regularly checks the repositories for updates. This means that the list of repositories is regularly updated, there is no need for you to keep track of this.

However, if you want to immediately check if something has changed for a repository, you can manually check for an update of the repository metadata.

To update a downloaded repository

These steps assume that you have already downloaded a repository. Follow these steps to update to a new software version of this repository.

  1. Create a backup and download that backup to another device.
  2. There are 2 ways to install an update for a repository:
    • Option 1: From the update notification under Settings > Updates.
      • Open the notification and read the release notes.
      • Select Install.
    • Option 2: From the HACS dashboard.
      • The repositories with updates have status Pending update.
      • Select the 3 dots menu, then select Redownload.
  3. If the repository is an integration, restart Home Assistant.

Help and support

Resources

Help us make these docs great!

All HACS docs are open source. See something that's wrong or unclear? Submit a pull request.

Edit this page on GitHub
Learn how to contribute

Still need help?