Backup in Home Assistant
backup
part of Home Assistant since 2022.4
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
- 540,402 (75.3 % of the installations that share statistics)
- Provides
- Diagnostics, Event, Sensor
- Maintained by
- @home-assistant/core
- Python packages
cronsim==2.7, securetar==2026.10.0
Setup
- This integration is set up in configuration.yaml, not in the user interface.
- 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 – Automates Home Assistant updates on a schedule. Requires update, schedule, and backup integrations.
- Automation Automated Daily Snapshot for Container/Core
Known issues and fixes
23 open issues and 13 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.3.
Open
- open Backups cannot be listed on Synology DSM devices. Affects: Synology DSM
- open Automated backups fail because a required file is missing.
- open Uploading backups fails with an SSL/TLS error related to encryption.
- open Deleting a backup from a NAS does not update the list in Home Assistant.
- open Creating a backup causes the system to freeze when it should not run.
- open Automatic backups stopped working after an update.
- open Backup uploads to later locations are skipped if an earlier location fails.
- open Backups to an SMB share show as failed in the UI but succeed in reality. Affects: SMB share
Fixed
- fixed in 2026.9.3 Encrypting and decrypting backup files was not handled correctly.
- fixed in 2026.9.1 Receiving backup files through streaming was not working properly.
- fixed in 2026.9.1 A potential deadlock occurred when receiving backup files.
- fixed in 2026.6.0 Backup uploads with unsafe file names were not blocked correctly.
- fixed in 2026.4.2 Calculating the size of encrypted backups was incorrect.
- fixed in 2026.4.0 Received backups were stored in the wrong temporary directory.
- fixed in 2026.3.3 An error during encryption/decryption was handled by the wrong system.
- fixed in 2025.11.2 A library used for scheduling backups was outdated.
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.