home-assistant/core · error · BackupManagerError

Error during post-backup: {result}

Error message

Error during post-backup: {result}

What it means

Raised by BackupManager.async_post_backup_actions when any registered backup platform's async_post_backup(hass) raises. Post-backup hooks run concurrently after backup generation (resuming recorder writes, unpausing databases); the first Exception is wrapped in BackupManagerError. The backup file itself is already written, but cleanup/resume steps failed.

Source

Thrown at homeassistant/components/backup/manager.py:527

        )
        for result in pre_backup_results:
            if isinstance(result, Exception):
                raise BackupManagerError(
                    f"Error during pre-backup: {result}"
                ) from result

    async def async_post_backup_actions(self) -> None:
        """Perform post backup actions."""
        post_backup_results = await asyncio.gather(
            *(
                platform.async_post_backup(self.hass)
                for platform in self.platforms.values()
            ),
            return_exceptions=True,
        )
        for result in post_backup_results:
            if isinstance(result, Exception):
                raise BackupManagerError(
                    f"Error during post-backup: {result}"
                ) from result

    async def load_platforms(self) -> None:
        """Load backup platforms."""
        await integration_platform.async_process_integration_platforms(
            self.hass,
            DOMAIN,
            self._add_platform,
            wait_for_platforms=True,
        )
        LOGGER.debug("Loaded %s platforms", len(self.platforms))
        LOGGER.debug("Loaded %s agents", len(self.backup_agents))

    async def _async_upload_backup(
        self,
        *,
        backup: AgentBackup,

View on GitHub (pinned to 58a3fdb3ea)

Solutions

1. Inspect the embedded underlying error in the message to identify the failing platform.
2. Restart or check the affected integration (e.g., reload recorder, verify DB connectivity) — the backup file is fine, but the system may still have paused writes.
3. Fix or update the integration whose async_post_backup raised.
4. Verify system health afterwards (recorder running, DB accepting writes) since post-hooks failed.

from homeassistant.components.backup.manager import BackupManagerError

try:
    await manager.async_post_backup_actions()
except BackupManagerError as err:
    LOGGER.error("post-backup failed: %s; verify recorder resumed", err)
    await verify_system_writable()

When it happens

Trigger: Completing a backup while a platform's post-backup hook raises — recorder failing to resume, database integrations erroring on unpause, or a buggy backup-platform implementation in a custom integration.

Common situations: Recorder database issues surfacing at resume time; the same integration that failed pre-backup also failing post-backup; systems where the DB went away during the (long) backup run.

Related errors

• Error during pre-backup: {result}
• You need at least Home Assistant version {backup_meta_versio
• Failed during {func.__name__}
• Failed to upload backup
• Backup {backup_id} not found

AI-assisted analysis of home-assistant/core@58a3fdb3ea (2026-08-14). Data as JSON: /api/errors/8e6b2b963e2ff753. Report an issue: GitHub.