When a single Wazuh host is enough and when to distribute
The all-in-one host suits small estates where a short outage is tolerable, and the distributed deployment suits estates that need availability or must scale past what one host can ingest. The quickstart sizes a single host for up to 100 endpoints with 90 days of indexed alerts, so that boundary is the first check. Above it, or where a missed alert window is unacceptable, plan for more than one host from the start. The decision turns on four drivers. Agent count sets the sizing tier: the quickstart lists 4 vCPU, 8 GiB RAM and 50 GB for 1 to 25 agents, and 8 vCPU, 8 GiB RAM and 200 GB for 51 to 100 agents. Retention multiplies storage, so confirm how many days of alerts your auditors or incident responders need before you size disks. Uptime requirement decides whether a restart of the one host is acceptable, and operating skills decide whether your team can run a server cluster and indexer cluster well. Note that the pre-built OVA bundles all central components on one Amazon Linux 2023 machine and, per the Wazuh virtual machine docs, does not provide high availability or scalability out of the box. Treat the OVA as an evaluation or small-estate option, not an availability design.
Before you commit, run a sizing exercise against your own numbers. Count servers, workstations and network devices, multiply by the per-device alert storage in the indexer installation guide, and compare the result with the disk you plan to provide. The guide's illustrative estimate for 80 workstations, 10 servers and 10 network devices is about 231 GB, which already exceeds the quickstart tier for 51 to 100 agents at 200 GB, so the quickstart figure is not a substitute for your own calculation. A distributed build adds hosts, certificates, load balancing and configuration drift to the work. Ask your platform team whether it can operate a multi-node indexer cluster and a master and worker server cluster, and confirm that the Wazuh server cluster documentation matches the release you plan to deploy. If the answer is no, a single host with tested backups and a documented restore may serve you better than an unfamiliar cluster.
How the components split across hosts
A Wazuh deployment can keep every central component on one host or spread them across an indexer cluster and a server cluster. The cards below show what each role owns and where the documented limits sit, so you can decide which parts need redundancy and which parts only need capacity.
All-in-one host
The indexer, server and dashboard run together on one machine, which is the layout the quickstart uses for smaller estates. Everything shares the same CPU, memory and disk, so alert indexing and agent event processing compete for resources. The documentation says this layout is usually enough for monitoring up to 100 endpoints with 90 days of indexed alert data. Check whether a single host failure is acceptable for your monitoring obligations before you rely on it.
Indexer cluster for scale
The Wazuh indexer, which stores alerts and supports search, can run as a multi-node cluster. The installation guide describes the cluster configuration as providing scalability, high availability and improved performance. Each indexer node has a documented minimum and a recommended size, so plan node count and per-node resources together. Ask your team to confirm how index shard and replica settings behave in your chosen layout before go-live.
Server cluster roles
A Wazuh server cluster has exactly one master node, and every other server is a worker. The master handles agent registration and deletion, shared configuration groups, and custom rules, decoders, SCA policies and CDB lists. Workers redirect enrollment requests to the master and process agent events. Confirm that your operations team understands which node must be reachable for changes to shared content.
Load balancer for agent connections
The server cluster docs state that a network load balancer can distribute agent connections across server nodes. This is how the cluster spreads agent event load, so the balancer sits in the agent data path and must be designed with the same availability target as the servers. Confirm the protocol and port handling your balancer supports against the Wazuh network requirements for your version. Test failover with real agents before depending on it.
Manual ossec.conf replication
Changes made to ossec.conf on the master are not synchronized to worker nodes. The documentation says these changes must be replicated by hand. Each worker can drift from the master if this step is missed, so treat it as a recurring operational task with a named owner. Add it to change control and to your configuration management process, and verify that workers match the master after each change.
How storage per device type sets the indexer size
The indexer is the component that grows with your estate, so the storage estimate decides whether a single host or a multi-node cluster is realistic. The Wazuh indexer installation guide estimates 90 days of alerts at about 3.7 GB per server, 1.5 GB per workstation and 7.4 GB per network device. Multiply each figure by the number of devices in that class and add the results to size the indexer's disk.
Illustrative example: 80 workstations, 10 servers and 10 network devices produce about 231 GB of indexed alerts over 90 days using the documented per-device figures. That total is roughly 120 GB for workstations, 37 GB for servers and 74 GB for network devices, so the mix matters more than the headcount. Note that this is a planning estimate from the guide, not a measured result, and it will not match your disk once index replicas, snapshots, overhead and free-space headroom are added. Also compare it with the sizing in the quickstart, which allots 50 GB for 1 to 25 agents and 200 GB for 51 to 100 agents, so a 100-agent estate with many network devices can exceed the quickstart figure.
Four inputs change the number. Retention moves it directly, so a 180-day requirement roughly doubles the 90-day total if the same ingest continues. Alert volume varies widely with rule tuning, file integrity monitoring scope and noisy log sources, and the per-device figures assume a typical load you must check. Endpoint mix shifts the total because network devices carry the largest per-device estimate. Finally, the cluster design adds replica copies that consume extra space. Ask Wazuh to confirm the assumptions behind each figure and whether replica settings are included. Then measure alerts per agent per day during a two-week pilot on your own endpoints and extrapolate to your retention target before buying disks or hosts.
Which deployment fits which situation
A lab or proof of concept exists to learn the product, test agent enrollment, write a few custom rules and check how alerts look in the dashboard. The Wazuh quickstart installs the indexer, server and dashboard on one host, and that single-node build is the sensible starting point because it keeps the number of moving parts low while the team learns the components.
- Topology: One all-in-one host running the indexer, server and dashboard, or the pre-built OVA virtual machine for a fast start.
- Risk accepted: No high availability. A host failure stops ingestion and the dashboard, and the OVA does not provide high availability or scalability out of the box.
- Sizing reference: The quickstart sizes an all-in-one host at 4 vCPU, 8 GiB RAM and 50 GB of storage for 1 to 25 agents.
- Trigger to move: Any plan to connect production endpoints, keep alert data for compliance, or rely on the platform for response.
- Keep in mind: Do not reuse lab data, rules or credentials in production without a documented rebuild.
Before leaving the lab, confirm the agent versions, retention settings and backup approach you will carry forward.
A small production estate of up to 100 endpoints is the range the Wazuh quickstart describes as usually enough for a single host with 90 days of indexed alert data. A single all-in-one host keeps administration simple, and one team can patch, back up and upgrade it without coordinating several server roles.
- Topology: One all-in-one host, sized from the quickstart: 8 vCPU, 8 GiB RAM and 200 GB of storage for 51 to 100 agents, based on 90 days of indexed alerts.
- Storage check: The indexer installation guide estimates about 3.7 GB per server, 1.5 GB per workstation and 7.4 GB per network device for 90 days of alerts, so the mix of device types changes the disk you need.
- Risk accepted: A single host is a single point of failure, so a host outage pauses monitoring until you restore.
- Trigger to move: Growing past the quickstart range, a requirement for uninterrupted monitoring, or a backup and restore window the business cannot tolerate.
- Keep in mind: Plan for a documented restore test, because a single host without tested backups carries the full risk.
Before you go live, ask your Wazuh partner or internal team to confirm the storage estimate against your actual device mix and retention period.
A regulated estate that must keep monitoring through a node failure needs more than one host. The Wazuh indexer can run as a multi-node cluster for scalability, high availability and improved performance, and the Wazuh server can run as a master and worker cluster with a network load balancer distributing agent connections across nodes. This build is justified when the outage risk is a control or contractual problem, not just an inconvenience.
- Topology: Multiple indexer nodes, a master server node, worker server nodes, and a load balancer in front of the agent connections.
- Node sizing: The indexer guide lists 4 GB RAM and 2 CPU cores as the minimum per node, and 16 GB RAM and 8 CPU cores as recommended.
- Operating effort: Changes to ossec.conf on the master are not synchronized to workers, so each change must be replicated by hand.
- Risk accepted: More hosts, more patching, more certificates and more failure modes to test, all handled by the same small team.
- Trigger to build this: A written availability requirement from the control owner, an audit finding on monitoring continuity, or a recovery objective a single host cannot meet.
Confirm with your auditor and control owner which availability evidence they expect before you finalize the design.
Large or multi-site estates usually need a distributed deployment from the start, with clear ownership of each role. The Wazuh quickstart itself recommends a distributed deployment for larger environments, and the server cluster separates a single master, which handles agent registration, shared configuration and custom rules, from workers that process agent events.
- Topology: A sized indexer cluster, a master and worker server cluster, a dashboard tier, and load balancing per site where network design requires it.
- Architecture choice: Decide whether sites share one cluster or run regional clusters, because that choice drives bandwidth, data residency and who can query what.
- Risk accepted: Cluster complexity grows with each site, and a misconfigured master affects every worker.
- Trigger to design this way: More endpoints than a single cluster can handle comfortably, data residency rules that split sites, or separate administrative domains.
- Keep in mind: Plan capacity by device type, since network devices generate much more indexed data per device than workstations.
Ask for a written architecture review that covers indexer sizing, master placement, certificate handling and upgrade order before committing to a multi-site build.
When high availability justifies the extra hosts
High availability justifies a distributed Wazuh deployment when losing the single host would stop detection for your estate and you have the staff to keep a cluster healthy. The Wazuh server cluster documentation describes horizontal scalability and high availability, but those properties come from adding hosts, and each host adds patching, certificates, monitoring and backups. Before committing, count what the extra hosts cost: at least a master and one worker on the server side, plus indexer nodes. The Wazuh indexer installation guide lists 4 GB RAM and 2 CPU cores as the minimum per indexer node and 16 GB RAM and 8 CPU cores as recommended, so a cluster sized to the recommendation costs far more hardware than the 8 GiB all-in-one host in the quickstart. Ask your infrastructure team for a quote on that node count and confirm the sizing with Wazuh before procurement.
The trade-off has a manual step that many teams underestimate. The server cluster documentation states that changes to ossec.conf on the master are not synchronized to workers and must be replicated by hand. Shared configuration groups, custom rules, decoders, SCA policies and CDB lists are managed on the master, so a missed change on a worker can leave agents processing events differently from one node to another. Build a written runbook for that replication, assign an owner, and test failover in a non-production copy. A network load balancer can spread agent connections across server nodes, but it does not remove this drift risk, so confirm how your change process will verify every node after each edit.
Clustering favors you when the estate is large enough that one host is a real bottleneck, when agent downtime during a host failure is unacceptable to your SOC, and when you already run clustered services and have people who can operate them. It does not favor you for a few dozen endpoints where the quickstart fits, for a team that cannot staff routine cluster maintenance, or for a pilot. In those cases, a well-backed-up single host with a tested restore procedure often gives better protection per hour of effort. Also note that the pre-built OVA does not provide high availability out of the box, so an OVA deployment should not be treated as a resilient platform.
How much effort and skill does a distributed Wazuh deployment take?
How much more does a distributed Wazuh deployment cost to run than one host?
A distributed deployment costs more mainly because it uses more hosts, more operating system and certificate work, and more people hours to keep them running. Wazuh is licensed under GPL-2.0 for the server and agent and Apache-2.0 for the indexer and dashboard, so there is no license fee to multiply by node count. The cost drivers are the number of indexer nodes, server nodes, load balancer capacity, storage per node and the staff time to patch and monitor the cluster. The Wazuh indexer guide lists 4 GB RAM and 2 CPU cores as the minimum per indexer node and 16 GB RAM and 8 CPU cores as recommended, so each extra node is a sizable virtual machine. Ask your provider to price each host, its storage and its operating hours in a written quote.
How long does it take to build a multi-node Wazuh cluster?
The build time depends on the scope, the number of nodes, the network and how much integration work sits around the cluster, so no fixed duration applies. A single-host quickstart is a different exercise from a multi-node build that includes certificates, cluster configuration, a load balancer and replicated custom rules. Wazuh's documentation does not give a build duration for a distributed deployment, so confirm the timeline with the vendor and against your own environment. For an engagement, DeployOpen agrees scope, deliverables and timelines in writing before work starts.
Can an in-house team deploy a multi-node Wazuh cluster from the documentation alone?
A team with solid Linux administration and networking skills can follow the documented guides, but the work is larger than the single-host quickstart. Wazuh documents a step-by-step installation, an offline installation guide and deployment via Ansible and Puppet, which help with repeatability. The risk sits in the parts the guides leave to you: sizing, certificate handling, node roles, and the manual replication of configuration changes. Wazuh's server cluster documentation says that changes to ossec.conf on the master are not synchronized to workers and must be replicated by hand. Teams without this experience should plan for a review of the design before cutover.
What skills and infrastructure does a distributed Wazuh deployment require?
The work needs people who can run several hosts reliably and secure the traffic between them. The main areas are:
- Linux administration for the indexer, server and dashboard hosts, including service management and time sync
- Networking for agent connections, cluster traffic, and the load balancer in front of the server nodes
- Certificate management for the indexer, server, dashboard and agent connections
- Storage planning, since the indexer's 90-day alert estimate depends on the number and type of devices
Confirm the exact ports, certificate authority and storage layout against the installation guide for your release before you commit to a design.
When should a team add a load balancer in front of Wazuh server nodes?
Add a load balancer when you run a server cluster and need agent connections spread across several server nodes. Wazuh's server cluster documentation says a network load balancer can distribute agent connections across server nodes, and that the cluster provides horizontal scalability and high availability. A load balancer does not replace the master node role, which still handles agent registration and deletion and shared configuration. Single-host or small deployments usually do not need one. Confirm the balancer type and health checks against the cluster documentation before you place it in production.
How do upgrades differ across Wazuh 4.14 patch releases in a cluster?
Patch upgrades in a cluster are more work than on one host because each node must be upgraded and checked in a controlled order. Wazuh shipped 4.14 patch releases on 17 March, 23 April, 1 July, 29 July, 23 September and 14 October 2026, roughly one every one to two months, according to the Wazuh release notes. Each release needs a rehearsal in a test environment, a configuration backup, and a review of any changed settings before rollout. Plan a recurring patch window for the cluster, and read the release notes for each version before you schedule it.
Does Wazuh Cloud change the effort of running a distributed deployment?
Wazuh Cloud changes who operates the platform, so the internal skill and infrastructure work shrinks, but the decision still depends on your data, residency and control requirements. Self-hosting keeps the indexer, server and dashboard in your own infrastructure, which means your team carries the cluster design, patching and storage planning. A managed service moves that operation to the vendor, while you still need to confirm regional hosting, data retention and any read-only access limits in its terms. Compare the managed option against your staffing and compliance needs in writing, and see the separate comparison of Wazuh Cloud and self-hosted Wazuh for the details.
How upgrades and backups change between the two models
In a single host deployment, the recurring work is patching one machine that runs the indexer, server and dashboard together, so a planned window covers every component at once. In a distributed deployment, the same patch cycle repeats for each indexer node, each server node and the dashboard, and the order matters. The master node handles agent registration and deletion and shared configuration, so it should be upgraded and verified before the workers. Expect ossec.conf changes on the master to be copied to workers by hand, since the Wazuh server cluster documentation says they are not synchronized automatically. Keep a written checklist of every node and every file that must match, and verify it after each change.
Indexer health becomes an ongoing duty once the cluster has several nodes. Someone should watch cluster status, shard allocation and disk headroom on each indexer node, because the indexer installation guide sizes a single deployment at about 231 GB for 80 workstations, 10 servers and 10 network devices, and that figure grows with retention. Backup planning also changes shape. Snapshots of the indexer, the server configuration and the custom rules, decoders and CDB lists must be tested with a restore, not just taken. Confirm with Wazuh which snapshot method and restore path apply to your version before you commit to a schedule.
The release cadence is a reason to plan upgrade windows early. Wazuh shipped 4.14 patch releases on 17 March, 23 April, 1 July, 29 July, 23 September and 14 October 2026, and a Wazuh 5.0.0 release candidate was published on October 5, 2026. A major version change can alter the upgrade path, so treat 5.0.0 as a planning item rather than a routine patch. Before you commit to either model, ask Wazuh to confirm the supported upgrade path from your current 4.14 release, the order of node upgrades in a cluster, and whether a rollback is supported. Record those answers in the runbook.
How a staged move from one host to a cluster runs
The sequence turns a single all-in-one Wazuh host into a distributed deployment in stages, so each layer is proven before the next one is added and agents move only after the cluster is verified.
Size the deployment from agents and devices
Start by counting agents by type and listing network devices that will send syslog or API data. Use the Wazuh quickstart sizing for an all-in-one host as the baseline, then apply the indexer storage estimates per device type (about 3.7 GB per server, 1.5 GB per workstation and 7.4 GB per network device for 90 days of alerts) to project indexer storage. Your team or DeployOpen produces a written sizing sheet with agent counts, retention, storage and node counts. The step is done when the sheet is approved and the retention period is confirmed in writing. Confirm any retention beyond 90 days with Wazuh, since the quickstart figures assume 90 days.
Build the all-in-one reference host
Install the indexer, server and dashboard on one host, following the quickstart or the installation guide for your platform. This reference deployment is a one-time build that becomes the known-good baseline for configuration, rules, decoders and agent enrollment. Enroll a small pilot group of agents and confirm alerts appear in the dashboard and are indexed. The step closes when the pilot agents report, alerts are searchable, and the configuration is exported into version control so later nodes can be compared against it.
Add indexer nodes to form a cluster
Add indexer nodes and join them into a multi-node indexer cluster, sized to the minimum and recommended per-node RAM and CPU in the indexer installation guide. Engineers set cluster membership, certificates and shard settings on each node, then check cluster health before moving on. This is a one-time build step, but certificate rotation and node replacement recur later. The step is done when every node reports as part of the cluster, the cluster health is green, and a test index survives the loss of one node in a planned test.
Add server workers and the master
Add server nodes to the Wazuh server cluster. The cluster has one master, which handles agent registration and deletion, shared configuration groups, custom rules, decoders, SCA policies and CDB lists. Every other server is a worker that redirects enrollment to the master and processes agent events. Confirm that each node joins the cluster and that the master reports all workers. The step closes when the cluster status lists every node as connected and a test agent enrolls through a worker and receives its configuration from the master.
Place a load balancer in front of workers
Place a network load balancer in front of the server nodes so agent connections spread across workers. The Wazuh server cluster documentation describes this pattern, and the load balancer is a separate piece of infrastructure that your network or cloud team owns. Test failover by taking one worker out of service and checking that agents reconnect to the remaining nodes. The step is done when a planned worker outage causes no loss of agent visibility, and the health checks and failover behavior are documented for the operations runbook.
Replicate configuration changes to workers
Changes to ossec.conf on the master are not synchronized to workers, so every configuration change must be copied to workers by hand or through a documented change process. Define which files are in scope, who makes each change, and how a diff is checked on every node. This step recurs for the life of the platform, so it should be written into change management and tested after each Wazuh patch release. The step closes when a sample configuration change is applied to all nodes and a diff across nodes shows no drift.
Cut over agents in controlled waves
Move agents to the cluster in groups, starting with a low-risk pilot and ending with the most critical systems. Each wave points agents at the load balancer address, confirms enrollment and checks that alerts from those hosts reach the indexer. Keep the reference host or prior configuration available until the last wave is verified. The step is done when every agent in the inventory reports through the cluster, no agent is silently missing from the dashboard, and the cutover record lists each wave with its verification result.
Hand over runbooks and recurring tasks
Document node roles, the configuration replication process, certificate and patch procedures, and the failover tests. Agree on which tasks recur, such as Wazuh patch upgrades (the 4.14 line has shipped several patch releases in 2026), certificate renewal, capacity checks and periodic failover tests. Scope, deliverables and timelines for the engagement are agreed in writing before work starts, and ongoing support can be handled under a retainer if the team wants it. The step is done when the runbooks are accepted by the internal operations owner and the recurring task list has named owners.
How DeployOpen scopes and runs Wazuh deployments
DeployOpen plans, implements, hardens, documents and supports self-hosted open-source platforms inside the client's own infrastructure, so the single-node or distributed choice is made against your network, hosts and recovery requirements. Engagements are fixed-scope, with scope, deliverables and timelines agreed in writing before work starts.
How we scope
- Agree the endpoint count, device mix and alert retention period that the Wazuh deployment must cover.
- Document where each Wazuh component runs, including indexer, server, dashboard and any load balancer.
- Record the availability target and recovery expectations that decide whether extra hosts are in scope.
- Confirm offline or air-gapped constraints, since they change installation and vulnerability data sourcing.
How we build
- Size indexer storage per device type against your retention period before any host is provisioned.
- Install the all-in-one or distributed topology in your cloud accounts, data centers or isolated networks.
- Configure agent enrollment, shared configuration groups, custom rules and decoders on the master node.
- Test agent connectivity through the load balancer and confirm the workers receive and process events.
How we hand over
- Deliver written documentation of topology, host sizing, storage assumptions and every manual configuration step.
- Set out the process for replicating changes that do not synchronize across server nodes, such as ossec.conf edits.
- Run a handover walkthrough so your operators can add agents, review alerts and follow the upgrade path.
- Provide backup and restore procedures for the indexer and server configuration as agreed in the scope.
How we support
- Ongoing support, upgrades and continuous testing are available as retainers after handover.
- Retainer scope can cover applying Wazuh patch releases and re-checking sizing as endpoint counts grow.
- Ask for a quote built from the written scope, which sets out who is paid for what and what recurs.

