Upgrading Wazuh agents on macOS systems

Follow these steps to upgrade Wazuh agents locally on macOS systems. If you want to perform a remote upgrade, check the Remote agent upgrade section to learn more.


To perform the agent upgrade, administrator privileges are required.

  1. Download the latest macOS installer:

  2. Run the macOS installer by using the command line interface (CLI) or the graphical user interface (GUI).

    To upgrade the Wazuh agent by using the command line, select your architecture, and run the installer:

    # installer -pkg wazuh-agent-4.8.0-1.intel64.pkg -target /


When upgrading agents from versions earlier than 4.x, make sure that the communication protocol is compatible. Up to that point, UDP was the default protocol and it was switched to TCP for later versions. Edit the agent configuration file ossec.conf to update the protocol or make sure that your Wazuh manager accepts both protocols.