Installing the Wazuh dashboard step by step

Installing package dependencies

1. Install the following packages if missing.

   APTYumDNF

   # apt-get install -y debhelper tar curl libcap2-bin #debhelper version 9 or later
   

Adding the Wazuh repository

Installing the Wazuh dashboard

1. Install the Wazuh dashboard package.

   APTYumDNF

   # apt-get -y install wazuh-dashboard
   

Configuring the Wazuh dashboard

1. Edit the /etc/wazuh-dashboard/opensearch_dashboards.yml file and replace the following values:

   1. server.host: This setting specifies the host of the Wazuh dashboard server. To allow remote users to connect, set the value to the IP address or DNS name of the Wazuh dashboard server. The value 0.0.0.0 will accept all the available IP addresses of the host.

   2. opensearch.hosts: The URLs of the Wazuh indexer instances to use for all your queries. The Wazuh dashboard can be configured to connect to multiple Wazuh indexer nodes in the same cluster. The addresses of the nodes can be separated by commas. For example, ["https://10.0.0.2:9200", "https://10.0.0.3:9200","https://10.0.0.4:9200"]

         server.host: 0.0.0.0
         server.port: 443
         opensearch.hosts: https://localhost:9200
         opensearch.ssl.verificationMode: certificate
      

   3. wazuh_core.hosts.url: This setting specifies the Wazuh manager master node. Replace <WAZUH_MANAGER_IP_ADDRESS> with the IP address or hostname of the Wazuh manager master node.

      wazuh_core.hosts:
        default:
          url: https://<WAZUH_MANAGER_IP_ADDRESS>
          port: 55000
          username: wazuh-wui
          password: wazuh-wui
          run_as: true
      

Deploying certificates

Note

Make sure that a copy of wazuh-certificates.tar file, created during the initial configuration step, is placed in your working directory.

1. Replace <DASHBOARD_NODE_NAME> with your Wazuh dashboard node name, the same one used in the config.yml file to create the certificates. In our case, the node name is, dashboard. Then move the certificates to their corresponding location:

   # NODE_NAME=<DASHBOARD_NODE_NAME>
   

   # 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
   # [ ! -e /etc/wazuh-dashboard/certs/dashboard.pem ] && mv -n /etc/wazuh-dashboard/certs/$NODE_NAME.pem /etc/wazuh-dashboard/certs/dashboard.pem
   # [ ! -e /etc/wazuh-dashboard/certs/dashboard-key.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
   

Starting the Wazuh dashboard service

1. Enable and start the Wazuh dashboard service.

   SystemdSysV Init

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

2. Access the Wazuh web interface with your admin user credentials. This is the default administrator account for the Wazuh indexer and it allows you to access the Wazuh dashboard.

   • URL: https://<WAZUH_DASHBOARD_IP_ADDRESS>

   • Username: admin

   • Password: admin

   When you access the Wazuh dashboard for the first time, the browser shows a warning message stating that the certificate was not issued by a trusted authority. An exception can be added in the advanced options of the web browser. For increased security, the root-ca.pem file previously generated can be imported to the certificate manager of the browser.