Updating Home Assistant, apps, and devices

Home Assistant shows the available updates for your integrations and devices in one place. On Home Assistant Operating SystemHome Assistant OS, the Home Assistant Operating System, is an embedded, minimalistic, operating system designed to run the Home Assistant ecosystem on single board computers (like the Raspberry Pi) or Virtual Machines. It includes Home Assistant Core, the Home Assistant Supervisor, and supports apps. Home Assistant Supervisor keeps it up to date, removing the need for you to manage an operating system. Home Assistant Operating System is the recommended installation type for most users., this includes updates for Home Assistant itself and your apps. You decide when to install them. You can install one update at a time, or all updates of an integration or of your apps at once.

You need an administrator account to install or skip updates.

Finding available updates

Home Assistant checks for updates regularly, and shows them on the Settings page and on the Updates page.

  1. Go to Settings > System > Updates.
    • The updates are grouped on cards:
      • Home Assistant: Updates of Home Assistant itself. Only on Home Assistant Operating SystemHome Assistant OS, the Home Assistant Operating System, is an embedded, minimalistic, operating system designed to run the Home Assistant ecosystem on single board computers (like the Raspberry Pi) or Virtual Machines. It includes Home Assistant Core, the Home Assistant Supervisor, and supports apps. Home Assistant Supervisor keeps it up to date, removing the need for you to manage an operating system. Home Assistant Operating System is the recommended installation type for most users..
      • One card for each integration that has updates, for example, ESPHome for the firmware of your ESPHome devices.
      • Apps: Updates of your apps. Only on Home Assistant Operating SystemHome Assistant OS, the Home Assistant Operating System, is an embedded, minimalistic, operating system designed to run the Home Assistant ecosystem on single board computers (like the Raspberry Pi) or Virtual Machines. It includes Home Assistant Core, the Home Assistant Supervisor, and supports apps. Home Assistant Supervisor keeps it up to date, removing the need for you to manage an operating system. Home Assistant Operating System is the recommended installation type for most users..
  2. To check for updates now, in the top-right corner, select Check for updates .

Updating Home Assistant itself

Before you update Home Assistant itself, prepare a backup and check the release notes for changes that affect your setup. The steps depend on your installation type:

  • Home Assistant Operating SystemHome Assistant OS, the Home Assistant Operating System, is an embedded, minimalistic, operating system designed to run the Home Assistant ecosystem on single board computers (like the Raspberry Pi) or Virtual Machines. It includes Home Assistant Core, the Home Assistant Supervisor, and supports apps. Home Assistant Supervisor keeps it up to date, removing the need for you to manage an operating system. Home Assistant Operating System is the recommended installation type for most users.: Refer to Updating Home Assistant Core and Updating the Home Assistant Operating System.
  • Home Assistant ContainerHome Assistant Container is a standalone container-based installation of Home Assistant Core. Any OCI compatible runtime can be used, but the documentation focus is on Docker. [Learn more]: You update the container. Home Assistant itself doesn’t show on the Updates page. Refer to Updating Home Assistant Container.

Updating an app, integration, or device

You install updates of apps, integrations, and devices from the Updates page. To update Home Assistant itself, refer to Updating Home Assistant itself.

  1. Go to Settings > System > Updates and select the update.
    • The dialog shows the installed version, the new version, and the release notes, if the update has them.
  2. For an app, choose whether to keep a backup of the current version. Turn Keep backup of the last version on or off.
  3. Select Update.

Installing all updates of a card

If an integration or your apps have several updates, you can install all of them at once.

  1. Go to Settings > System > Updates.
  2. On the card, select Update all.
    • Home Assistant installs all updates of that card. It doesn’t create backups first, not even for apps.
    • The Home Assistant card doesn’t have this button. Install those updates one at a time.

Skipping an update

If you don’t want to install an update, you can skip it. Home Assistant then hides the update until a newer version comes out.

To skip an update from the UI

  1. Go to Settings > System > Updates and select the update.
  2. Select Skip.
    • If the app updates automatically, you can’t skip the update. To skip it, first turn off Auto update for the app.

To see skipped updates

  1. Go to Settings > System > Updates.
  2. In the top-right corner, select the three dots menu, and then select Show skipped updates.
    • Result: The skipped updates show on their own card.
  3. To install a skipped update, select it, and then select Clear skipped.

To skip updates from an automation or a script

Use the Skip update and Clear skipped update actions.

Updating apps automatically

On Home Assistant Operating SystemHome Assistant OS, the Home Assistant Operating System, is an embedded, minimalistic, operating system designed to run the Home Assistant ecosystem on single board computers (like the Raspberry Pi) or Virtual Machines. It includes Home Assistant Core, the Home Assistant Supervisor, and supports apps. Home Assistant Supervisor keeps it up to date, removing the need for you to manage an operating system. Home Assistant Operating System is the recommended installation type for most users., apps can update automatically. Home Assistant itself and the operating system only update when you install the update.

  1. Go to Settings > Apps and select the app.
  2. On the Info tab, turn on Auto update.
    • Home Assistant waits at least one day after a new version is released before it updates the app.
    • It creates an app update backup before each update.
    • If the app’s developer marked a version as a breaking change, the app doesn’t update automatically to that version. Install that update yourself.

Updates you can’t install from Home Assistant

Some integrations let you know about an update, but you can’t install it from Home Assistant. These updates show on a separate card on the Updates page. To install such an update, use the app or the website of the device’s manufacturer.