{"record":{"id":"2f4e918f82cba5a0","repo":"home-assistant/core","slug":"addons-and-folders-are-not-supported-by-core-backu","errorCode":null,"errorMessage":"Addons and folders are not supported by core backup","messagePattern":"Addons and folders are not supported by core backup","errorType":"exception","errorClass":"BackupReaderWriterError","httpStatus":null,"severity":"error","filePath":"homeassistant/components/backup/manager.py","lineNumber":1735,"sourceCode":"        self,\n        *,\n        agent_ids: list[str],\n        backup_name: str,\n        extra_metadata: dict[str, bool | str],\n        include_addons: list[str] | None,\n        include_all_addons: bool,\n        include_database: bool,\n        include_folders: list[Folder] | None,\n        include_homeassistant: bool,\n        on_progress: Callable[[CreateBackupEvent], None],\n        password: str | None,\n    ) -> tuple[NewBackup, asyncio.Task[WrittenBackup]]:\n        \"\"\"Initiate generating a backup.\"\"\"\n        date_str = dt_util.now().isoformat()\n        backup_id = _generate_backup_id(date_str, backup_name)\n\n        if include_addons or include_all_addons or include_folders:\n            raise BackupReaderWriterError(\n                \"Addons and folders are not supported by core backup\"\n            )\n        if not include_homeassistant:\n            raise BackupReaderWriterError(\"Home Assistant must be included in backup\")\n\n        backup_task = self._hass.async_create_task(\n            self._async_create_backup(\n                agent_ids=agent_ids,\n                backup_id=backup_id,\n                backup_name=backup_name,\n                extra_metadata=extra_metadata,\n                include_database=include_database,\n                date_str=date_str,\n                on_progress=on_progress,\n                password=password,\n            ),\n            name=\"backup_manager_create_backup\",\n            eager_start=False,  # To ensure the task is not started before we return","sourceCodeStart":1717,"sourceCodeEnd":1753,"githubUrl":"https://github.com/home-assistant/core/blob/58a3fdb3ea0538617f0a07efcfba6294de64fd59/homeassistant/components/backup/manager.py#L1717-L1753","documentation":"BackupReaderWriterError raised by the core backup reader/writer when a backup creation request includes addons, all addons, or folders. Plain Home Assistant Core (no Supervisor/add-ons) cannot back up add-ons or share folders, so these flags are only valid on supervised/HAOS-style backups handled elsewhere.","triggerScenarios":"Calling the core backup create path (_async_init_create_backup / the core backup websocket API) with include_addons=True, include_all_addons=True, or a non-empty include_folders list.","commonSituations":"A client or script written for a Supervised install is run against HA Core in a container/venv; UI or API payload copied from a HAOS setup; an integration builds a create-backup request with addon flags unconditionally.","solutions":["Set include_addons/include_all_addons to False and include_folders to None/[] when running on HA Core","If you need addon/folder backups, run Home Assistant OS or Supervised instead of Core","Gate the request on what the instance supports (hass.components / supervisor availability) before sending it"],"exampleFix":"// before\n{\"include_addons\": [\"core_ssh\"], \"include_folders\": [\"media\"], ...}\n// after\n{\"include_addons\": false, \"include_folders\": null, \"include_homeassistant\": true, ...}","handlingStrategy":"validation","validationCode":"# client-side: only add these flags on supervised installs\npayload = {\"include_homeassistant\": True}\nif \"hassio\" in hass.config.components:\n    payload[\"include_folders\"] = folders\n# never send include_addons/all_addons/folders to a Core install","typeGuard":null,"tryCatchPattern":"try:\n    await core_writer.async_create_backup(...)\nexcept BackupReaderWriterError as err:\n    if \"not supported by core backup\" in str(err):\n        # strip addon/folder flags and rebuild the request\n        ...","preventionTips":["Feature-detect the install type (Core vs Supervised) before building backup options","Default addon/folder flags to off and only enable when supported","Document which backup flags your client supports per install type"],"tags":["home-assistant","backup","validation","core-vs-supervised"],"backgroundTag":null,"analyzedSha":"58a3fdb3ea0538617f0a07efcfba6294de64fd59","analyzedAt":"2026-08-14T20:54:38.818Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}