Back to the overview

Home Assistant Supervisor in Home Assistant

hassio part of Home Assistant since 0.42

Local, polling Quality: Internal

The Home Assistant Supervisor integration connects Home Assistant with local system services to manage and monitor the Home Assistant instance. It provides entities for backup management, system diagnostics, and update checks, enabling users to oversee core operations and maintenance tasks.

Typical uses

  • Monitoring system status
  • Managing backups
  • Checking for updates
  • Controlling system settings

Facts about this integration

Compatible with Home Assistant
yes, official integration
Connection
Local, polling – Talks to the device on your own network and asks for changes at regular intervals.
Setup
in configuration.yaml
Kind
Integration
Quality scale
Internal – Part of Home Assistant itself, not rated separately.
Installations
457,802 (63.8 % of the installations that share statistics)
Categories
Backup, Binary sensor, Sensor, Switch, Update
Provides
Backup, Binary sensor, Diagnostics, Sensor, Switch, Update
Maintained by
@home-assistant/supervisor
Python packages
aiohasupervisor==0.9.0

Setup

  1. This integration is set up in configuration.yaml, not in the user interface.
  2. The documentation lists the exact entries; restart Home Assistant after adding them.

Blueprints that use this integration

  • Automation Update notifications – Sends update notifications via mobile app, using update entities and Hassio services. ♥ 114 · Import · Forum
  • Automation Automated Daily Snapshot – Schedules a daily backup using Hassio and notifies via the mobile app integration. ♥ 57 · Import · Forum
  • Automation Home Assistant Auto-update ♥ 30 · Import · Forum
  • Automation Advanced Auto-Updater – Automates system updates with input text and boolean controls, notifying users via Home Assistant. ♥ 25 · Import · Forum
  • Automation Renew Let's Encrypt Certificate – Automatically renews Let's Encrypt certificates and notifies via mobile app. ♥ 11 · Import · Forum
  • Automation Send a mobile notification when add-on update is available – Notifies via mobile app when add-on updates are available using Hassio integration. ♥ 11 · Import · Forum

All blueprints for it

Known issues and fixes

13 open issues and 39 bug fixes in the last twelve months are recorded for Home Assistant Supervisor in the Home Assistant issue tracker. If something does not work, update first: the most recent fix shipped with Home Assistant 2026.11.0.

Open

  • open Deleting a backup from a NAS does not update the list in Home Assistant since December 28, 2024 · 2 reactions · 16 comments · #134158
  • open The DNS resolver sometimes returns incomplete CNAME chains when using UDP since September 10, 2026 · 2 reactions · 5 comments · #181849
  • open Reported problem #188626 since October 26, 2026 · 0 reactions · 21 comments · #188626
  • open An error occurs when accessing the Supervisor API since August 25, 2026 · 0 reactions · 9 comments · #180173
  • open The Apps section may indicate an update is available for a local app even though it isn't yet since August 5, 2026 · 0 reactions · 5 comments · #178257
  • open Backup password checks cause Supervisor HTTP connections to leak, exhausting the Core's connection pool since October 22, 2026 · 0 reactions · 3 comments · #187974
  • open Backup jobs may be marked as failed even though the backup completes successfully since August 14, 2026 · 0 reactions · 3 comments · #179188
  • open Reported problem #174919 since June 26, 2026 · 0 reactions · 3 comments · #174919

Fixed

  • fixed in 2026.11.0 Bug fix #189404 Fix #189404 · Issue #189390
  • fixed in 2026.10.0 Changing managed app settings may reset existing configuration options Fix #182441
  • fixed in 2026.10.0 Leaving an app's log page can cause Supervisor connection leaks Fix #183772
  • fixed in 2026.9.1 Removing an app during repair flows does not warn the user that its data will be deleted Fix #181009
  • fixed in 2026.8.2 The hassio config entry is not created during setup, causing delays Fix #178677
  • fixed in 2026.7.3 Add-on update entities are not refreshed after a store reload via the Supervisor API Fix #176648 · Issue #176584
  • fixed in 2026.7.2 The hassio coordinator is not refreshed after an OS update is installed Fix #176004
  • fixed in 2026.7.0 Bug fix #174063 Fix #174063
  • fixed in 2026.6.0 During onboarding, the Supervisor may not be updated to the latest version Fix #171129
  • fixed in 2026.5.2 Specifying folders during a partial backup may cause an AttributeError in hassio Fix #170312 · Issue #170175
  • fixed in 2026.5.1 Authenticating via the Supervisor Unix socket may trigger an IndexError Fix #169911
  • fixed in 2026.2.3 The backup stage of a Core or App update does not display a progress indicator Fix #162683 · Issue #162684

Source: the issue tracker of Home Assistant, as of November 1, 2026. The sentences are written by a language model from the titles of the issues; the reports themselves are on GitHub.

Check a specific device for known problems in the product check →

Source of this entry: the official documentation of the integration
The description was written by a language model from the facts listed here, not taken from the documentation.

Scroll to Top