home-assistant/core · warning · ConfigEntryNotReady

Timed out connecting to august api

Error message

Timed out connecting to august api

What it means

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.

Source

Thrown at homeassistant/components/august/__init__.py:56

    if "auth_implementation" not in entry.data:
        # This is a legacy entry using username/password, trigger reauth
        raise ConfigEntryAuthFailed("Migration to OAuth required")

    session = async_create_august_clientsession(hass)
    try:
        implementation = await async_get_config_entry_implementation(hass, entry)
    except ImplementationUnavailableError as err:
        raise ConfigEntryNotReady("OAuth implementation not available") from err
    oauth_session = OAuth2Session(hass, entry, implementation)
    august_gateway = AugustGateway(Path(hass.config.config_dir), session, oauth_session)
    try:
        await async_setup_august(hass, entry, august_gateway)
    except OAuth2TokenRequestReauthError as err:
        raise ConfigEntryAuthFailed from err
    except (RequireValidation, InvalidAuth) as err:
        raise ConfigEntryAuthFailed from err
    except TimeoutError as err:
        raise ConfigEntryNotReady("Timed out connecting to august api") from err
    except (
        AugustApiAIOHTTPError,
        OAuth2TokenRequestError,
        ClientError,
        CannotConnect,
    ) as err:
        raise ConfigEntryNotReady from err
    await hass.config_entries.async_forward_entry_setups(entry, PLATFORMS)
    return True


async def async_remove_entry(hass: HomeAssistant, entry: AugustConfigEntry) -> None:
    """Remove an August config entry."""
    ir.async_delete_issue(hass, DOMAIN, "yale_brand_migration")


async def async_unload_entry(hass: HomeAssistant, entry: AugustConfigEntry) -> bool:
    """Unload a config entry."""

View on GitHub (pinned to 58a3fdb3ea)

Solutions

1. Check general internet/DNS from the HA host (the August app on the same network is a good control)
2. Do nothing for transient outages — the entry retries automatically with backoff
3. If persistent, reload the August integration after connectivity is confirmed; verify no firewall blocks api.august.com
4. Check status.august.com for cloud incidents

When it happens

Trigger: 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.

Common situations: August cloud degradation; HA host network/DNS problems; slow links causing the initial setup payload (locks, cameras, activities) to exceed limits.

Understand the failure class

• Timeouts: ETIMEDOUT, deadlines, and hung requests — what actually expires when a request times out.

Related errors

• Timeout connecting to CalDAV server
• Credential is already linked to a user
• Unable to connect to Abode: {ex}
• Failed to connect
• {error}

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