Catch up on the latest product updates, best practices, and expert insights from the Checkmk Conference #12 – Watch the livestream recordings now

Werk #20073: Agent Updater: Configuration error on Checkmk update when proxy settings are active

Component Agent bakery
Title Agent Updater: Configuration error on Checkmk update when proxy settings are active
Date Jul 10, 2026
Level Trivial Change
Class Bug Fix
Compatibility Compatible - no manual interaction needed
Checkmk versions & editions
2.5.0p10 Checkmk Pro, Checkmk Ultimate, Checkmk Cloud, Checkmk Ultimate MT

With previous patch versions of Checkmk 2.5, a migration bug in the Agent Updater ruleset could block a site update from Checkmk 2.4 to Checkmk 2.5. More precisely: When configuring the Agent Updater rule, activating Proxy Settings > Provide proxy settings, but not providing credentials, the following traceback shows up on omd update, and the site update aborts.

-| Traceback (most recent call last):
-|   File "/omd/sites/v240/lib/python3/cmk/update_config/main.py", line 101, in main_check_config
-|     check_config(logger, conflict)
-|     ~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^
-|   File "/omd/sites/v240/lib/python3/cmk/update_config/main.py", line 254, in check_config
-|     pre_action(logger, conflict_mode)
-|     ~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^
-|   File "/omd/sites/v240/lib/python3/cmk/update_config/plugins/pre_actions/rulesets.py", line 60, in __call__
-|     result = _validate_rule_values(
-|         rulesets,
-|     ...<2 lines>...
-|         logger,
-|     )
-|   File "/omd/sites/v240/lib/python3/cmk/update_config/plugins/pre_actions/rulesets.py", line 188, in _validate_rule_values
-|     validation_errors = visitor.validate(RawDiskData(rule.value))
-|   File "/omd/sites/v240/lib/python3/cmk/gui/form_specs/visitors/_base.py", line 54, in validate
-|     if nested_validations := self._validate(parsed_value):
-|                              ~~~~~~~~~~~~~~^^^^^^^^^^^^^^
-|   File "/omd/sites/v240/lib/python3/cmk/gui/form_specs/visitors/transform.py", line 65, in _validate
-|     ).validate(parsed_value)
-|       ~~~~~~~~^^^^^^^^^^^^^^
-|   File "/omd/sites/v240/lib/python3/cmk/gui/form_specs/visitors/_base.py", line 54, in validate
-|     if nested_validations := self._validate(parsed_value):
-|                              ~~~~~~~~~~~~~~^^^^^^^^^^^^^^
-|   File "/omd/sites/v240/lib/python3/cmk/gui/form_specs/visitors/dictionary.py", line 198, in _validate
-|     for validation in element_visitor.validate(parsed_value[key_name]):
-|                       ~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^
-|   File "/omd/sites/v240/lib/python3/cmk/gui/form_specs/visitors/_base.py", line 45, in validate
-|     self._migrate_disk_value(raw_value)
-|     ~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^
-|   File "/omd/sites/v240/lib/python3/cmk/gui/form_specs/visitors/_base.py", line 81, in _migrate_disk_value
-|     return RawDiskData(value=self.form_spec.migrate(value.value))
-|                              ~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^
-|   File "/omd/sites/v240/lib/python3/cmk/plugins/checkmk/rulesets/cmk_update_agent.py", line 76, in _migrate_proxy_old_format
-|     protocol, credentials = _parse_proxy_protocol(proxy_config)
-|                             ~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^
-|   File "/omd/sites/v240/lib/python3/cmk/plugins/checkmk/rulesets/cmk_update_agent.py", line 103, in _parse_proxy_protocol
-|     return "http", credentials["credentials"]
-|                    ~~~~~~~~~~~^^^^^^^^^^^^^^^
-| KeyError: 'credentials'
-|
-| Update aborted with Error: 'credentials'.
-| The update can be retried after the error has been fixed.

The site update will now succeed for all updates from Checkmk 2.4 to Checkmk 2.5 patch versions containing this Werk.

To the list of all Werks