You can install Wazuh on a single host by using a script that automatically detects whether the operating system uses
The script performs a health check to verify that the available system resources meet the minimal requirements. For more information, check the requirements section.
The script installs Java Development Kit and other packages, including
libcap, required by Open Distro for Elasticsearch. Besides, the Search Guard offline TLS tool is used to generate the certificates for protecting data in the Elastic Stack.
Root user privileges are required to run all the commands. The
curl package is used to download the script.
Run the following command:
# curl -so ~/all-in-one-installation.sh https://raw.githubusercontent.com/wazuh/wazuh-documentation/4.1/resources/open-distro/unattended-installation/all-in-one-installation.sh && bash ~/all-in-one-installation.sh
The script performs a health check to ensure that the host has enough resources to guarantee proper performance. To skip this step, add the
--ignore-healthcheckoption when running the script.
After executing the script, a message is shown to confirm that the installation was successful.
Starting the installation... Installing all necessary utilities for the installation... Done Adding the Wazuh repository... Done Installing the Wazuh manager... Done Wazuh-manager started Installing Open Distro for Elasticsearch... Done Configuring Elasticsearch... Certificates created Elasticsearch started Initializing Elasticsearch... Done Installing Filebeat... Filebeat started Done Installing Open Distro for Kibana... Kibana started Done Checking the installation... Elasticsearch installation succeeded. Filebeat installation succeeded. Initializing Kibana (this may take a while) ######## Installation finished
Access the web interface:
URL: https://<wazuh_server_ip> user: admin password: admin
On the first access to Kibana, the browser displays a warning message indicating that the certificate was not issued by a trusted authority. It is possible to add an exception in the browser’s advanced options or, for increased security, the previously generated
root-ca.pem file can be imported into the certificate manager of the browser. Alternatively, it is possible to configure a certificate from a trusted authority.
The Open Distro for Elasticsearch performance analyzer plugin is removed during the installation since it might have a negative impact on system resources.
Customizing the installation¶
The Kibana configuration found at the
/etc/kibana/kibana.yml file has the
server.host parameter set to
0.0.0.0. This means that Kibana can be accessed from the outside and accepts all the available IPs of the host. This value can be changed for a specific IP if needed.
It is highly recommended to change Elasticsearch default passwords for the users’ found at the
/usr/share/elasticsearch/plugins/opendistro_security/securityconfig/internal_users.yml file. For more information on Elasticsearch configuration and passwords, check the Elasticsearch tuning section.
To uninstall all the components of the all-in-one installation, see the uninstalling section.
Once the Wazuh environment is ready, a Wazuh agent can be installed in every endpoint to be monitored. To learn how to install agents, check the Wazuh agent section.