OSI Global › Guides › Wazuh

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.

Level: Beginner–IntermediateTime: ~30 minutesWazuh 4.14Updated Nov 2026

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

AgentsCPURAMStorage (90 days)
1–254 vCPU8 GB50 GB
26–508 vCPU16 GB100 GB
51–1008 vCPU16 GB200 GB

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.

Lost the password? Every generated credential is in 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.txt

Step 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

  1. In the dashboard open Agents management → Summary → Deploy new agent.
  2. Choose the endpoint OS, enter the Wazuh server address, and give the agent a name and group.
  3. Copy the generated command, run it on the endpoint, then start the agent service it tells you to start.
  4. Within a minute the agent appears as Active and starts sending events.

Step 6 — First things to turn on

Troubleshooting

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.

Written by Dr. Vivek Khare — Author, Speaker, IT Leader with 25+ years of experience, ISO 27001 Lead Auditor and founder of OSI Global. Spotted something out of date? Tell us via the community form.