Victron GX: Invalid Config - Integration Blocked

[ntwb]

The problem

The Victron GX Integration is no longer able to start, HA issues a notification that the integration is not able to be setup:

Invalid config

The following integrations and platforms could not be set up:

victron_gx (Show logs) Please check your config and logs.

What version of Home Assistant Core has the issue?

2026.8.2

What was the last working version of Home Assistant Core?

2026.7.x

What type of installation are you running?

Home Assistant OS

Integration causing the issue

Victron GX

Link to integration documentation on our website

Introduced in 3d444ea

Diagnostics information

Enabling debug-logging and restarting the integration a modal pops up stating that the integration successfully reloaded… It did not…

The logs from this are attached here:

Example YAML snippet

n/a

Anything in the logs that might be useful for us?

The logs I have thus far are:

1. 3 Instances


Log details (ERROR)
Logger: homeassistant.components.victron_gx
Source: config_entries.py:4187
Integration: victron_gx ([documentation](https://www.home-assistant.io/integrations/victron_gx), [issues](https://github.com/home-assistant/core/issues?q=is%3Aissue+is%3Aopen+label%3A%22integration%3A+victron_gx%22))
First occurred: 12:24:39 PM (3 occurrences)
Last logged: 12:24:40 PM

Error occurred loading flow for integration victron_gx: cannot import name 'UPDATE_FREQUENCY_AUTO' from 'victron_mqtt' (/usr/local/lib/python3.14/site-packages/victron_mqtt/__init__.py)


2. 2 Instances


Logger: homeassistant.util.loop
Source: util/loop.py:75
First occurred: 12:16:01 PM (2 occurrences)
Last logged: 12:24:39 PM

Detected blocking call to import_module with args ('homeassistant.components.victron_gx',) in /usr/src/homeassistant/homeassistant/loader.py, line 1091: ComponentProtocol, importlib.import_module(self.pkg_path) inside the event loop; This is causing stability issues. Please create a bug report at https://github.com/home-assistant/core/issues?q=is%3Aopen+is%3Aissue For developers, please see https://developers.home-assistant.io/docs/asyncio_blocking_operations/#import_module Traceback (most recent call last): File "<frozen runpy>", line 203, in _run_module_as_main File "<frozen runpy>", line 88, in _run_code File "/usr/src/homeassistant/homeassistant/__main__.py", line 227, in <module> sys.exit(main()) File "/usr/src/homeassistant/homeassistant/__main__.py", line 213, in main exit_code = runner.run(runtime_conf) File "/usr/src/homeassistant/homeassistant/runner.py", line 290, in run return loop.run_until_complete(setup_and_run_hass(runtime_config)) File "/usr/local/lib/python3.14/asyncio/base_events.py", line 706, in run_until_complete self.run_forever() File "/usr/local/lib/python3.14/asyncio/base_events.py", line 677, in run_forever self._run_once() File "/usr/local/lib/python3.14/asyncio/base_events.py", line 2056, in _run_once handle._run() File "/usr/local/lib/python3.14/asyncio/events.py", line 94, in _run self._context.run(self._callback, *self._args) File "/usr/src/homeassistant/homeassistant/setup.py", line 168, in async_setup_component result = await _async_setup_component(hass, domain, config) File "/usr/src/homeassistant/homeassistant/setup.py", line 341, in _async_setup_component component = await integration.async_get_component() File "/usr/src/homeassistant/homeassistant/loader.py", line 1043, in async_get_component comp = self._get_component() File "/usr/src/homeassistant/homeassistant/loader.py", line 1091, in _get_component ComponentProtocol, importlib.import_module(self.pkg_path)
Detected blocking call to import_module with args ('homeassistant.components.victron_gx.config_flow',) in /usr/src/homeassistant/homeassistant/loader.py, line 1321: return importlib.import_module(f"{self.pkg_path}.{platform_name}") inside the event loop; This is causing stability issues. Please create a bug report at https://github.com/home-assistant/core/issues?q=is%3Aopen+is%3Aissue For developers, please see https://developers.home-assistant.io/docs/asyncio_blocking_operations/#import_module Traceback (most recent call last): File "<frozen runpy>", line 203, in _run_module_as_main File "<frozen runpy>", line 88, in _run_code File "/usr/src/homeassistant/homeassistant/__main__.py", line 227, in <module> sys.exit(main()) File "/usr/src/homeassistant/homeassistant/__main__.py", line 213, in main exit_code = runner.run(runtime_conf) File "/usr/src/homeassistant/homeassistant/runner.py", line 290, in run return loop.run_until_complete(setup_and_run_hass(runtime_config)) File "/usr/local/lib/python3.14/asyncio/base_events.py", line 706, in run_until_complete self.run_forever() File "/usr/local/lib/python3.14/asyncio/base_events.py", line 677, in run_forever self._run_once() File "/usr/local/lib/python3.14/asyncio/base_events.py", line 2056, in _run_once handle._run() File "/usr/local/lib/python3.14/asyncio/events.py", line 94, in _run self._context.run(self._callback, *self._args) File "/usr/src/homeassistant/homeassistant/config_entries.py", line 1549, in async_init flow, result = await self._async_init(flow_id, handler, context, data) File "/usr/src/homeassistant/homeassistant/config_entries.py", line 1603, in _async_init flow = await self.async_create_flow(handler, context=context, data=data) File "/usr/src/homeassistant/homeassistant/config_entries.py", line 1854, in async_create_flow handler = await _async_get_flow_handler( File "/usr/src/homeassistant/homeassistant/config_entries.py", line 4206, in _async_get_flow_handler await _load_integration(hass, domain, hass_config) File "/usr/src/homeassistant/homeassistant/config_entries.py", line 4185, in _load_integration await integration.async_get_platform("config_flow") File "/usr/src/homeassistant/homeassistant/loader.py", line 1124, in async_get_platform platforms = await self.async_get_platforms((platform_name,)) File "/usr/src/homeassistant/homeassistant/loader.py", line 1190, in async_get_platforms platforms.update(self._load_platforms(platform_names)) File "/usr/src/homeassistant/homeassistant/loader.py", line 1114, in _load_platforms platform_name: self._load_platform(platform_name) File "/usr/src/homeassistant/homeassistant/loader.py", line 1289, in _load_platform cache[full_name] = self._import_platform(platform_name) File "/usr/src/homeassistant/homeassistant/loader.py", line 1321, in _import_platform return importlib.import_module(f"{self.pkg_path}.{platform_name}")


3. 1 Instance


Logger: homeassistant.setup
Source: setup.py:341
First occurred: 12:16:01 PM (1 occurrence)
Last logged: 12:16:01 PM

Setup failed for 'victron_gx': Unable to import component: cannot import name 'UPDATE_FREQUENCY_AUTO' from 'victron_mqtt' (/usr/local/lib/python3.14/site-packages/victron_mqtt/__init__.py)
Traceback (most recent call last):
  File "/usr/src/homeassistant/homeassistant/loader.py", line 1031, in async_get_component
    comp = await self.hass.async_add_import_executor_job(
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
        self._get_component, True
        ^^^^^^^^^^^^^^^^^^^^^^^^^
    )
    ^
  File "/usr/local/lib/python3.14/concurrent/futures/thread.py", line 86, in run
    result = ctx.run(self.task)
  File "/usr/local/lib/python3.14/concurrent/futures/thread.py", line 73, in run
    return fn(*args, **kwargs)
  File "/usr/src/homeassistant/homeassistant/loader.py", line 1091, in _get_component
    ComponentProtocol, importlib.import_module(self.pkg_path)
                       ~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^
  File "/usr/src/homeassistant/homeassistant/util/loop.py", line 201, in protected_loop_func
    return func(*args, **kwargs)
  File "/usr/local/lib/python3.14/importlib/__init__.py", line 88, in import_module
    return _bootstrap._gcd_import(name[level:], package, level)
           ~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "<frozen importlib._bootstrap>", line 1406, in _gcd_import
  File "<frozen importlib._bootstrap>", line 1371, in _find_and_load
  File "<frozen importlib._bootstrap>", line 1342, in _find_and_load_unlocked
  File "<frozen importlib._bootstrap>", line 938, in _load_unlocked
  File "<frozen importlib._bootstrap_external>", line 759, in exec_module
  File "<frozen importlib._bootstrap>", line 491, in _call_with_frames_removed
  File "/usr/src/homeassistant/homeassistant/components/victron_gx/__init__.py", line 9, in <module>
    from .hub import Hub, VictronGxConfigEntry
  File "/usr/src/homeassistant/homeassistant/components/victron_gx/hub.py", line 7, in <module>
    from victron_mqtt import (
    ...<10 lines>...
    )
ImportError: cannot import name 'UPDATE_FREQUENCY_AUTO' from 'victron_mqtt' (/usr/local/lib/python3.14/site-packages/victron_mqtt/__init__.py)

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "/usr/src/homeassistant/homeassistant/setup.py", line 341, in _async_setup_component
    component = await integration.async_get_component()
                ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/src/homeassistant/homeassistant/loader.py", line 1051, in async_get_component
    self._component_future.result()
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^
  File "/usr/src/homeassistant/homeassistant/loader.py", line 1043, in async_get_component
    comp = self._get_component()
  File "/usr/src/homeassistant/homeassistant/loader.py", line 1091, in _get_component
    ComponentProtocol, importlib.import_module(self.pkg_path)
                       ~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^
  File "/usr/src/homeassistant/homeassistant/util/loop.py", line 201, in protected_loop_func
    return func(*args, **kwargs)
  File "/usr/local/lib/python3.14/importlib/__init__.py", line 88, in import_module
    return _bootstrap._gcd_import(name[level:], package, level)
           ~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "<frozen importlib._bootstrap>", line 1406, in _gcd_import
  File "<frozen importlib._bootstrap>", line 1371, in _find_and_load
  File "<frozen importlib._bootstrap>", line 1342, in _find_and_load_unlocked
  File "<frozen importlib._bootstrap>", line 938, in _load_unlocked
  File "<frozen importlib._bootstrap_external>", line 759, in exec_module
  File "<frozen importlib._bootstrap>", line 491, in _call_with_frames_removed
  File "/usr/src/homeassistant/homeassistant/components/victron_gx/__init__.py", line 9, in <module>
    from .hub import Hub, VictronGxConfigEntry
  File "/usr/src/homeassistant/homeassistant/components/victron_gx/hub.py", line 7, in <module>
    from victron_mqtt import (
    ...<10 lines>...
    )
ImportError: cannot import name 'UPDATE_FREQUENCY_AUTO' from 'victron_mqtt' (/usr/local/lib/python3.14/site-packages/victron_mqtt/__init__.py)

Additional information

No response

[home-assistant]

Hey there @tomer-w, mind taking a look at this issue as it has been labeled with an integration (victron_gx) you are listed as a code owner for? Thanks!

Code owner commands

Code owners of victron_gx can trigger bot actions by commenting:

• @home-assistant close Closes the issue.
• @home-assistant rename Awesome new title Renames the issue.
• @home-assistant reopen Reopen the issue.
• @home-assistant unassign victron_gx Removes the current integration label and assignees on the issue, add the integration domain after the command.
• @home-assistant add-label needs-more-information Add a label (needs-more-information, problem in dependency, problem in custom component, problem in config, problem in device, feature-request) to the issue.
• @home-assistant remove-label needs-more-information Remove a label (needs-more-information, problem in dependency, problem in custom component, problem in config, problem in device, feature-request) on the issue.

_{^{(message by CodeOwnersMention)}}

---

@ntwb Thanks for reporting this issue!

Before we dive in, please make sure this isn't a duplicate by searching through existing issues. Also check recently closed issues, as your problem might already be fixed but not yet released.

https://github.com/home-assistant/core/issues?q=%20label%3A%22integration%3A%20victron_gx%22%20
_{^{(message by IssueContext)}}

---

victron_gx documentation
victron_gx source
_{^{(message by IssueLinks)}}

[ntwb]

GitHub is failing at uploading screenshots, or the ~2MB .log file, nor the .log file zip’d.

Its stuck at <!-- Uploading "home-assistant_victron_mqtt_2026-08-15T04-03-33.089Z.log.zip"... —>

[tomer-w]

It seems you somehow have old version of victron-mqtt library. Do you see any issues in the log with regards to download the latest version?