Asuswrt broke with 2025.12.2: Error setting up entry for asuswrt

I upgraded HA from 2025.11.3 to 12.2 and looks like my asuswrt integration broke completely, showing as “failed to set up” in the Devices / Integrations page, and logging the following error on startup:

Traceback (most recent call last):
  File "/usr/src/homeassistant/homeassistant/config_entries.py", line 761, in __async_setup_with_context
    result = await component.async_setup_entry(hass, self)
             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/src/homeassistant/homeassistant/components/asuswrt/__init__.py", line 18, in async_setup_entry
    await router.setup()
  File "/usr/src/homeassistant/homeassistant/components/asuswrt/router.py", line 231, in setup
    await self._api.async_connect()
  File "/usr/src/homeassistant/homeassistant/components/asuswrt/bridge.py", line 389, in async_connect
    await self._api.async_connect()
  File "/usr/local/lib/python3.13/site-packages/asusrouter/asusrouter.py", line 203, in async_connect
    return await self.async_get_identity() is not None
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/local/lib/python3.13/site-packages/asusrouter/asusrouter.py", line 293, in async_get_identity
    self._identity = await collect_identity(
                     ^^^^^^^^^^^^^^^^^^^^^^^
    ...<2 lines>...
    )
    ^
  File "/usr/local/lib/python3.13/site-packages/asusrouter/modules/identity.py", line 126, in collect_identity
    endpoints, onboarding = await _check_endpoints(api_query)
                            ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/local/lib/python3.13/site-packages/asusrouter/modules/identity.py", line 230, in _check_endpoints
    onboarding = process_onboarding(
                 ~~~~~~~~~~~~~~~~~~^
        read_onboarding(contents[Endpoint.ONBOARDING])
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    ).get(AsusData.AIMESH, {})
    ^
  File "/usr/local/lib/python3.13/site-packages/asusrouter/modules/endpoint/onboarding.py", line 47, in process
    for node in [process_aimesh_node(device)]
                 ~~~~~~~~~~~~~~~~~~~^^^^^^^^
  File "/usr/local/lib/python3.13/site-packages/asusrouter/modules/endpoint/onboarding.py", line 98, in process_aimesh_node
    level = safe_int(data.get("level", "0"))
                     ^^^^^^^^
AttributeError: 'str' object has no attribute 'get'

This is with an ASUS AiMesh setup running 3.0.0.6. No recent changes or reboots to the ASUS setup.

When I try to reload the HA asuswrt integration, I do see the following in my router’s logs:

Dec 8 19:13:24 HTTPD: [LOGIN][http][APP] success (<<HA's internal IP ADDRESS>>)

I did notice that 2025.12.2 did come with this change:

Bump asusrouter to 1.21.1 (@Vaskivskyi - #158192)

@Vaskivskyi any ideas on how to troubleshoot this one?

Thanks!

Looks like @Shuntfield also reported this here:

1 Like

Same here since 2025.12.2…

same issue since 2025.12.2…

same issue since 2025.12.2, previously roborock crashed since 2025.12.1 many bugs with 2025.12.x releases :frowning:

michaeltlp

michaeltlp commented now

michaeltlp

now

I am facing the same connectivity issue with my XT8 after upgrading to 2025.12.2

Hello, guys

I am really sorry for this issue on 2025.12.2. Unfortunately, unit tests for the backend library did not catch an important case of data formatting in the device API. The issue also did not happen on the physical device I have for testing

The fix was merged into the HA dev branch (Bump asusrouter to 1.21.3 by Vaskivskyi · Pull Request #158492 · home-assistant/core · GitHub) and will be released with 2025.12.3

2 Likes

The same happen for me too!

I updated to 12.3 and still having issues.

If the same issue persists with 2025.12.3, please provide an error log. If your error log is showing issues with aioasuswrt library - this is an unrelated new issue in 2025.12.3 and should be checked here [asuswrt] 2025.12.3 Failed to set up: KeyError (aioasuswrt) · Issue #158822 · home-assistant/core

Logger: homeassistant.config_entries
Source: config_entries.py:761
First occurred: December 13, 2025 at 6:41:13 PM (2 occurrences)
Last logged: December 13, 2025 at 6:52:34 PM

Error setting up entry for asuswrt
Traceback (most recent call last):
  File "/usr/src/homeassistant/homeassistant/config_entries.py", line 761, in __async_setup_with_context
    result = await component.async_setup_entry(hass, self)
             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/src/homeassistant/homeassistant/components/asuswrt/__init__.py", line 18, in async_setup_entry
    await router.setup()
  File "/usr/src/homeassistant/homeassistant/components/asuswrt/router.py", line 231, in setup
    await self._api.async_connect()
  File "/usr/src/homeassistant/homeassistant/components/asuswrt/bridge.py", line 248, in async_connect
    await self._get_label_mac()
  File "/usr/src/homeassistant/homeassistant/components/asuswrt/bridge.py", line 280, in _get_label_mac
    label_mac = await self._get_nvram_info("LABEL_MAC")
                ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/src/homeassistant/homeassistant/components/asuswrt/bridge.py", line 270, in _get_nvram_info
    info = await self._api.async_get_nvram(info_type)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/local/lib/python3.13/site-packages/aioasuswrt/asuswrt.py", line 449, in async_get_nvram
    regex = _NVRAM_REGEX.format(item)
KeyError: '<item>'
Log details (ERROR)
Logger: homeassistant.config_entries
Source: config_entries.py:761
First occurred: 19:55:34 (2 occurrences)
Last logged: 20:00:16

Error setting up entry 192.168.1.1 for asuswrt
Traceback (most recent call last):
  File "/usr/src/homeassistant/homeassistant/config_entries.py", line 761, in __async_setup_with_context
    result = await component.async_setup_entry(hass, self)
             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/src/homeassistant/homeassistant/components/asuswrt/__init__.py", line 18, in async_setup_entry
    await router.setup()
  File "/usr/src/homeassistant/homeassistant/components/asuswrt/router.py", line 231, in setup
    await self._api.async_connect()
  File "/usr/src/homeassistant/homeassistant/components/asuswrt/bridge.py", line 248, in async_connect
    await self._get_label_mac()
  File "/usr/src/homeassistant/homeassistant/components/asuswrt/bridge.py", line 280, in _get_label_mac
    label_mac = await self._get_nvram_info("LABEL_MAC")
                ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/src/homeassistant/homeassistant/components/asuswrt/bridge.py", line 270, in _get_nvram_info
    info = await self._api.async_get_nvram(info_type)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/local/lib/python3.13/site-packages/aioasuswrt/asuswrt.py", line 449, in async_get_nvram
    regex = _NVRAM_REGEX.format(item)
KeyError: '<item>'

Both are related to the different 2025.12.3 issue with the second (SSH/Telnet) library aioasuswrt as I commented before

The original issue here was fixed in 2025.12.3. Any other issue should be reported properly separately

Thanks, fixed as of today

  • Core2025.12.4
  • Supervisor2025.12.3