2.0 KiB
| title | description | ha_category | ha_release | ha_quality_scale | ha_domain | ha_codeowners | ha_iot_class | ha_integration_type | ||
|---|---|---|---|---|---|---|---|---|---|---|
| Backup | Allow creating backups of container and core installations. |
|
2022.4 | internal | backup |
|
Calculated | system |
The Backup integration allow you to create and download backups for your Home Assistant Core and Home Assistant Container installations. This backup file can be used if you migrate to Home Assistant Operating System.
If you use Home Assistant Operating System or Home Assistant Supervised, back up functionality is already built-in.
Manual configuration
The backup integration is by default enabled. If you've disabled or removed the default_config: line from your configuration the following example shows you how to enable this integration manually:
# Example configuration.yaml entry
backup:
You need to restart Home Assistant after you add this configuration. When it has started up again you will find a new "Backup" entry in the main menu ({% my backup title="Settings > System > Backups" %}).
The backup files are stored in a new "backups" subdirectory in the root of your configuration directory.
Services
The backup integration exposes a service that can be used to automate the backup process.
Service {% my developer_call_service service="backup.create" %}
The {% my developer_call_service service="backup.create" %} service can be used to create a backup for your Home Assistant instance.
The service has no additional options or parameters.
Example service call:
service: backup.create
Example: Backing up every night at 3:00 AM
This is a YAML example for an automation that initiate a backup every night at 3 AM:
automation:
- alias: "Backup Home Assistant every night at 3 AM"
trigger:
platform: time
at: "03:00:00"
action:
alias: "Create backup now"
service: backup.create