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-clusterddaemon runs on every node. Worker nodes connect to the master node on port1516by 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.