home-assistant/core · error · ConfigEntryNotReady

ConfigEntryNotReady

Error message

ConfigEntryNotReady

What it means

Error "ConfigEntryNotReady" thrown in home-assistant/core.

Source

Thrown at homeassistant/components/bosch_shc/__init__.py:48

async def async_setup_entry(hass: HomeAssistant, entry: BoschConfigEntry) -> bool:
    """Set up Bosch SHC from a config entry."""
    data = entry.data

    zeroconf = await async_get_instance(hass)
    try:
        session = await hass.async_add_executor_job(
            SHCSession,
            data[CONF_HOST],
            data[CONF_SSL_CERTIFICATE],
            data[CONF_SSL_KEY],
            False,
            zeroconf,
        )
    except SHCAuthenticationError as err:
        raise ConfigEntryAuthFailed from err
    except SHCConnectionError as err:
        raise ConfigEntryNotReady from err

    shc_info = session.information
    if TYPE_CHECKING:
        assert shc_info is not None and shc_info.unique_id is not None
    if shc_info.updateState.name == "UPDATE_AVAILABLE":
        _LOGGER.warning("Please check for software updates in the Bosch Smart Home App")

    entry.runtime_data = session

    device_registry = dr.async_get(hass)
    device_registry.async_get_or_create(
        config_entry_id=entry.entry_id,
        connections={(dr.CONNECTION_NETWORK_MAC, shc_info.unique_id)},
        identifiers={(DOMAIN, shc_info.unique_id)},
        manufacturer="Bosch",
        name=entry.title,
        model="SmartHomeController",
        sw_version=shc_info.version,

View on GitHub (pinned to 58a3fdb3ea)

Solutions

1. Verify the Bosch Smart Home Controller is powered on and reachable on the local network.
2. Check that the configured host/IP address of the Smart Home Controller is still correct.
3. Ensure the SSL certificate and key files configured for the integration still exist and are readable.
4. Restart the Bosch Smart Home Controller and reload the integration; Home Assistant will retry setup automatically.

Example fix

Verify the Smart Home Controller host/IP is reachable on the network and that it is powered on, then reload the config entry. Home Assistant retries setup automatically (ConfigEntryNotReady).

When it happens

Trigger: Thrown at homeassistant/components/bosch_shc/__init__.py:48 when the library encounters an invalid state.

Common situations: See trigger scenarios.

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