Wazuh manager cluster

The Wazuh manager cluster runs multiple Wazuh manager nodes as a single service. It distributes Wazuh agent connections and event processing across nodes, allowing the deployment to scale horizontally as you add endpoints.

Every Wazuh manager is a cluster node, even in a single-node deployment. A standalone Wazuh manager consists of one master node with no worker nodes. To scale the deployment, add worker nodes that connect to the master node.

You can combine the cluster with a network load balancer. The load balancer provides a single address for the Wazuh agents and distributes their connections across the cluster nodes.

Cluster at a glance

The cluster follows a set of rules that shape how you plan, secure, and scale it. The following sections explain each rule in detail.

  • A cluster has exactly one master node and any number of worker nodes.

  • The wazuh-manager-clusterd daemon runs on every node. Worker nodes connect to the master node on port 1516 by default.

  • The master node replicates agent keys, enrollment credentials, and group configuration to worker nodes.

  • Every node accepts Wazuh agent connections on HTTPS port 1517.

  • Only the master node creates agent identities and runs the Wazuh manager API.

  • Each node maintains its own configuration file and TLS certificates. The cluster does not replicate these files.