home-assistant/core · warning · ConfigEntryNotReady

OAuth implementation not available

Error message

OAuth implementation not available

What it means

ConfigEntryNotReady('OAuth implementation not available') raised when async_get_config_entry_implementation raises ImplementationUnavailableError — the OAuth2 implementation recorded for the August entry (typically via application credentials) cannot currently be provided. NotReady means HA will retry setup with backoff rather than demanding reauth.

Source

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

from .data import AugustData
from .gateway import AugustGateway
from .util import async_create_august_clientsession

type AugustConfigEntry = ConfigEntry[AugustData]


async def async_setup_entry(hass: HomeAssistant, entry: AugustConfigEntry) -> bool:
    """Set up August from a config entry."""
    # Check if this is a legacy config entry that needs migration to OAuth
    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)

View on GitHub (pinned to 58a3fdb3ea)

Solutions

1. Wait one coordinator retry cycle — NotReady retries automatically and often self-heals once the provider loads
2. Verify the application credential for August exists under Settings > Application Credentials (or restore it)
3. If a custom implementation was removed permanently, delete and recreate the August config entry

When it happens

Trigger: The August OAuth implementation is provided by an application_credentials entry (often from a cloud/Nabu Casa helper or custom wrapper) that is not yet loaded or was removed; race during startup where the provider integration loads after August.

Common situations: Custom application credentials deleted after the August entry was created; startup ordering issues after moving config between instances; the credentials-providing integration failed to load.

Related errors

• Migration to OAuth required
• oauth2_implementation_unavailable
• No application_credentials platform for {domain}
• Cannot delete credential in use by integration {entry.domain
• Timed out connecting to august api

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