How to Install Wazuh (Open-Source SIEM & XDR) on a Single Server
A practical, all-in-one Wazuh 4.14 install on Ubuntu or RHEL using the official installation assistant: server, indexer and dashboard on one host, then your first agent.
What Wazuh gives you
Wazuh is a free, open-source security platform (GPLv2 / Apache 2.0) that combines SIEM and XDR: log collection and correlation, file-integrity monitoring, vulnerability detection, configuration assessment against CIS benchmarks, and compliance reporting (PCI DSS, HIPAA, GDPR, ISO 27001-aligned controls). It is three central components — the Wazuh server, the Wazuh indexer and the Wazuh dashboard — plus a lightweight agent on every endpoint.
Before you start
| Agents | CPU | RAM | Storage (90 days) |
|---|---|---|---|
| 1–25 | 4 vCPU | 8 GB | 50 GB |
| 26–50 | 8 vCPU | 16 GB | 100 GB |
| 51–100 | 8 vCPU | 16 GB | 200 GB |
- 64-bit Linux (x86_64 or ARM64): Ubuntu 20.04 / 22.04 / 24.04, RHEL 8/9/10, Amazon Linux 2023 or CentOS Stream 10.
- A fresh VM with a static IP and
sudoaccess. Don't co-host it with other web apps. - Open ports:
443/tcp(dashboard),1514/tcpand1515/tcp(agent connection and enrolment),55000/tcp(API, restrict to admins).
Step 1 — Update the server
sudo apt update && sudo apt -y upgrade # Ubuntu
# sudo dnf -y update # RHEL / CentOS Stream
Step 2 — Run the Wazuh installation assistant
The assistant downloads, installs and configures all three central components with self-signed certificates.
curl -sO https://packages.wazuh.com/4.14/wazuh-install.sh
sudo bash ./wazuh-install.sh -a
When it finishes, the summary prints the dashboard URL, the user admin and a generated password. Copy it somewhere safe.
wazuh-install-files.tar in the directory where you ran the script:sudo tar -O -xvf wazuh-install-files.tar wazuh-install-files/wazuh-passwords.txtStep 3 — Log in to the dashboard
Browse to https://<server-ip> and accept the self-signed certificate warning (replace it with a real certificate before production). Sign in as admin.
Step 4 — Stop accidental upgrades
Wazuh components must be upgraded together. Disable the package repository so a routine apt upgrade doesn't break the stack:
sudo sed -i "s/^deb /#deb /" /etc/apt/sources.list.d/wazuh.list && sudo apt update # Ubuntu
# sudo sed -i "s/^enabled=1/enabled=0/" /etc/yum.repos.d/wazuh.repo # RHEL
Step 5 — Enrol your first agent
- In the dashboard open Agents management → Summary → Deploy new agent.
- Choose the endpoint OS, enter the Wazuh server address, and give the agent a name and group.
- Copy the generated command, run it on the endpoint, then start the agent service it tells you to start.
- Within a minute the agent appears as Active and starts sending events.
Step 6 — First things to turn on
- Vulnerability detection: on by default in 4.x. Check Vulnerability Detection after the first scan.
- Configuration assessment (SCA): CIS hardening checks per agent.
- File integrity monitoring: add critical paths (for example
/etcor web roots) to the agent group configuration. - Email or Slack alerts: configure integrations in
/var/ossec/etc/ossec.confon the server.
Troubleshooting
- Dashboard not loading:
sudo systemctl status wazuh-indexer wazuh-manager wazuh-dashboard. The indexer needs its RAM; 4 GB hosts often fail. - Agent stuck "Never connected": check that ports 1514/1515 are open from the endpoint to the server and that the server address in the agent's
ossec.confis right. - Re-run cleanly:
sudo bash ./wazuh-install.sh -uuninstalls the central components.
Next steps
For more than 100 agents or high availability, move to a distributed deployment (multi-node indexer and server cluster). Pair Wazuh with a honeypot (see our Cowrie honeypot guide) to get high-signal alerts on anyone probing your network.