Werk #19426: Agent Bakery: Allow configuring Windows agent communication channel

Component	Agent bakery
Title	Agent Bakery: Allow configuring Windows agent communication channel
Date	Mar 5, 2026
Level	Trivial Change
Class	New Feature
Compatibility	Compatible - no manual interaction needed
Checkmk versions & editions	2.6.0b1 Not yet released Checkmk Enterprise (CEE), Checkmk Cloud (CCE), Checkmk MSP (CME) 2.5.0b1 Not yet released Checkmk Enterprise (CEE), Checkmk Cloud (CCE), Checkmk MSP (CME) 2.4.0p24 Not yet released Checkmk Enterprise (CEE), Checkmk Cloud (CCE), Checkmk MSP (CME)

You can now configure the internal communication channel between the Windows agent and the Agent Controller directly through the Agent Bakery.

A new option Internal agent communication channel is available in the Windows Agent Controller ruleset. By default, a mailslot is used for local communication. If you encounter problems with mailslot communication in your environment (e.g., due to security policies), you can switch to a TCP socket on localhost instead, with a configurable port (default: 28250).

Previously, the only way to change this was to manually edit check_mk.user.yml on every monitored host.

Note: We recommend leaving this on the default (Mailslot) unless you actually encounter problems.

To the list of all Werks