Back to the overview

Backup in Home Assistant

backup part of Home Assistant since 2022.4

Calculated Quality: Internal

The Backup integration connects Home Assistant with an online backup service to manage and monitor data backups. It provides sensor data and diagnostics related to backup status and events.

Typical uses

  • Automating backup processes
  • Monitoring backup success/failure
  • Generating backup diagnostics
  • Triggering alerts on backup events

Facts about this integration

Compatible with Home Assistant
yes, official integration
Connection
Calculated – Works on data Home Assistant already has, without a device of its own.
Setup
in configuration.yaml
Kind
Online service
Quality scale
Internal – Part of Home Assistant itself, not rated separately.
Installations
514,020 (75.3 % of the installations that share statistics)
Categories
Event, Other, Sensor
Provides
Diagnostics, Event, Sensor
Maintained by
@home-assistant/core
Python packages
cronsim==2.7, securetar==2026.4.1

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 Home Assistant Auto-update on a schedule base v2026.6.0 ♥ 46 · Import · Forum
  • Automation Automated Daily Snapshot for Container/Core ♥ 4 · Import · Forum

All blueprints for it

Known issues and fixes

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

Open

  • open Backups cannot be listed when using Synology DSM. Affects: Synology DSM since June 7, 2025 · 9 reactions · 19 comments · #146275
  • open New backups exclude the local addons/ directory. since February 6, 2025 · 4 reactions · 9 comments · #137569
  • open Failed backups cause the recorder to stop. since April 2, 2026 · 3 reactions · 10 comments · #167186
  • open Automated backups fail because a required file is missing. since May 15, 2025 · 3 reactions · 4 comments · #144963
  • open Uploading backups fails with an SSL/TLS error related to a bad record MAC. since April 11, 2025 · 2 reactions · 40 comments · #142740
  • open Deleting a backup from a NAS does not update the Home Assistant backup list. since December 28, 2024 · 2 reactions · 16 comments · #134158
  • open Creating a backup results in a system freeze when the system is not running. since August 11, 2025 · 2 reactions · 9 comments · #150410
  • open Automatic backups have stopped working after an update. since May 17, 2026 · 2 reactions · 6 comments · #170976

Fixed

  • fixed in 2026.9.1 Receiving backup streams was not functioning correctly. Fix #181012 · Issue #180502 · Issue #178574
  • fixed in 2026.9.1 A potential deadlock occurred during backup file reception. Fix #181070
  • fixed in 2026.6.0 Backup uploads with unsafe internal filenames were not properly rejected. Fix #172368
  • fixed in 2026.4.2 Encrypting backups had incorrect securetar size calculations. Fix #167602 · Issue #167385
  • fixed in 2026.4.0 Received backups were stored outside the temporary backup directory. Fix #166982
  • fixed in 2026.3.3 An abort exception during backup encryption/decryption was handled incorrectly. Fix #165852 · Issue #165769
  • fixed in 2025.11.2 Updating the cronsim library to a newer version. Fix #155648

Source: the issue tracker of Home Assistant, as of September 13, 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