Install Wazuh Dashboard Step-by-Step

The Wazuh dashboard is the web UI for visualizing Wazuh data. This guide installs it from packages following the official Wazuh documentation. Run as root.

1. Install dependencies

# Debian/Ubuntu
apt-get install debhelper tar curl libcap2-bin

2. Add the Wazuh repository

Skip if already added for the indexer or server.

apt-get install gnupg apt-transport-https
curl -s https://packages.wazuh.com/key/GPG-KEY-WAZUH | gpg --no-default-keyring --keyring gnupg-ring:/usr/share/keyrings/wazuh.gpg --import && chmod 644 /usr/share/keyrings/wazuh.gpg
echo "deb [signed-by=/usr/share/keyrings/wazuh.gpg] https://packages.wazuh.com/4.x/apt/ stable main" | tee -a /etc/apt/sources.list.d/wazuh.list
apt-get update

3. Install the dashboard package

apt-get -y install wazuh-dashboard

4. Configure the dashboard

Edit `/etc/wazuh-dashboard/opensearch_dashboards.yml` and set:

server.host: 0.0.0.0
server.port: 443
opensearch.hosts: https://<INDEXER_IP>:9200

5. Deploy the certificates

NODE_NAME=dashboard
mkdir /etc/wazuh-dashboard/certs
tar -xf ./wazuh-certificates.tar -C /etc/wazuh-dashboard/certs/ ./$NODE_NAME.pem ./$NODE_NAME-key.pem ./root-ca.pem
mv -n /etc/wazuh-dashboard/certs/$NODE_NAME.pem /etc/wazuh-dashboard/certs/dashboard.pem
mv -n /etc/wazuh-dashboard/certs/$NODE_NAME-key.pem /etc/wazuh-dashboard/certs/dashboard-key.pem
chmod 500 /etc/wazuh-dashboard/certs
chmod 400 /etc/wazuh-dashboard/certs/*
chown -R wazuh-dashboard:wazuh-dashboard /etc/wazuh-dashboard/certs

6. Start the dashboard

systemctl daemon-reload
systemctl enable wazuh-dashboard
systemctl start wazuh-dashboard

7. First login

Open `https://<DASHBOARD_IP>` in your browser. Log in with the default `admin` / `admin` credentials and rotate the password immediately. The Wazuh stack is now ready to enroll agents.