{"record":{"id":"d392bf9a698371a1","repo":"home-assistant/core","slug":"timed-out-connecting-to-august-api","errorCode":null,"errorMessage":"Timed out connecting to august api","messagePattern":"Timed out connecting to august api","errorType":"exception","errorClass":"ConfigEntryNotReady","httpStatus":null,"severity":"warning","filePath":"homeassistant/components/august/__init__.py","lineNumber":56,"sourceCode":"    if \"auth_implementation\" not in entry.data:\n        # This is a legacy entry using username/password, trigger reauth\n        raise ConfigEntryAuthFailed(\"Migration to OAuth required\")\n\n    session = async_create_august_clientsession(hass)\n    try:\n        implementation = await async_get_config_entry_implementation(hass, entry)\n    except ImplementationUnavailableError as err:\n        raise ConfigEntryNotReady(\"OAuth implementation not available\") from err\n    oauth_session = OAuth2Session(hass, entry, implementation)\n    august_gateway = AugustGateway(Path(hass.config.config_dir), session, oauth_session)\n    try:\n        await async_setup_august(hass, entry, august_gateway)\n    except OAuth2TokenRequestReauthError as err:\n        raise ConfigEntryAuthFailed from err\n    except (RequireValidation, InvalidAuth) as err:\n        raise ConfigEntryAuthFailed from err\n    except TimeoutError as err:\n        raise ConfigEntryNotReady(\"Timed out connecting to august api\") from err\n    except (\n        AugustApiAIOHTTPError,\n        OAuth2TokenRequestError,\n        ClientError,\n        CannotConnect,\n    ) as err:\n        raise ConfigEntryNotReady from err\n    await hass.config_entries.async_forward_entry_setups(entry, PLATFORMS)\n    return True\n\n\nasync def async_remove_entry(hass: HomeAssistant, entry: AugustConfigEntry) -> None:\n    \"\"\"Remove an August config entry.\"\"\"\n    ir.async_delete_issue(hass, DOMAIN, \"yale_brand_migration\")\n\n\nasync def async_unload_entry(hass: HomeAssistant, entry: AugustConfigEntry) -> bool:\n    \"\"\"Unload a config entry.\"\"\"","sourceCodeStart":38,"sourceCodeEnd":74,"githubUrl":"https://github.com/home-assistant/core/blob/58a3fdb3ea0538617f0a07efcfba6294de64fd59/homeassistant/components/august/__init__.py#L38-L74","documentation":"ConfigEntryNotReady('Timed out connecting to august api') raised when async_setup_august raises TimeoutError while fetching initial lock/camera data from the August cloud. HA marks the entry not-ready and retries setup with exponential backoff; the integration stays offline until a retry succeeds.","triggerScenarios":"August API endpoints slow or unreachable: DNS hangs, TLS handshake stalls, or the augustpy/yalexs library's HTTP request exceeds its timeout during setup; internet outage at HA boot.","commonSituations":"August cloud degradation; HA host network/DNS problems; slow links causing the initial setup payload (locks, cameras, activities) to exceed limits.","solutions":["Check general internet/DNS from the HA host (the August app on the same network is a good control)","Do nothing for transient outages — the entry retries automatically with backoff","If persistent, reload the August integration after connectivity is confirmed; verify no firewall blocks api.august.com","Check status.august.com for cloud incidents"],"exampleFix":null,"handlingStrategy":"retry","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":["Ensure stable internet before HA restarts with August loaded","Let the backoff retry loop work; avoid repeated manual reloads","Check August cloud status during extended failures"],"tags":["august","cloud","timeout","config-entry","network"],"backgroundTag":null,"analyzedSha":"58a3fdb3ea0538617f0a07efcfba6294de64fd59","analyzedAt":"2026-08-14T20:54:38.818Z","schemaVersion":2},"datasetVersion":"2026-08-15T17:31:12.345Z"}