Requirements

Make sure that your environment meets these requirements before you enroll a Wazuh agent:

  1. An installed and running Wazuh manager.

  2. An installed and running Wazuh agent on the endpoint that you want to enroll.

  3. Outbound connectivity from the Wazuh agent to the Wazuh manager services. The ports required depend on the agent version:

    • Wazuh 5.0 agents: 1517/TCP (HTTPS) for both enrollment and ongoing agent communication.

    • Wazuh 4.x agents:

      • 1514/TCP for agent communication.

      • 1515/TCP for enrollment through automatic agent request.

    • 55000/TCP for enrollment through the Wazuh manager API (both agent versions).

Note

On the Wazuh manager, the 1517 and 1514 listeners are bound to 127.0.0.1 by default and only accept local connections. To accept Wazuh agents from other endpoints, set <bind_addr>0.0.0.0</bind_addr> (for <https>) and <local_ip>0.0.0.0</local_ip> (for <legacy>) in wazuh-manager.conf.

Supported operating systems

Wazuh 5.0 supports Wazuh agent installation on the following operating systems:

  • Linux:

    • RHEL / CentOS (AMD64): 6 and later

    • RHEL / CentOS (ARM64): 7 and later

    • AlmaLinux: 8 and later

    • Rocky Linux: 8 and later

    • Amazon Linux: 1 and later

    • Debian: 7 and later

    • Fedora: 41 and later

    • openSUSE Leap: 15

    • Oracle Linux: 6 and later

    • SUSE / SLES: 15

    • Ubuntu: 18.04 and later

  • macOS: 14 or later

  • Windows: 7 and later

  • Windows Server: 2008 R2 and later

Note

Wazuh 4.x agents can enroll with and connect to Wazuh 5.0 managers. However, some agent-side components are not fully supported until the agent is upgraded to Wazuh 5.0. This affects File Integrity Monitoring (FIM), Security Configuration Assessment (SCA), System Inventory, Active Response, and Vulnerability Detection.

We recommend upgrading Wazuh 4.x agents to Wazuh 5.0 after enrollment to ensure full compatibility with Wazuh 5.0 functionality. For more information, see Upgrade agents remotely.

Note

You can find instructions for installing and enrolling agents in the Wazuh dashboard. Go to Agents management > Summary, and click Deploy new agent.