This is the documentation for Wazuh 3.1. Check out the docs for the latest version of Wazuh!

Install Wazuh agent from sources

This guide describes how to install the Wazuh agent from source code.

Note

Many of the commands described below need to be executed with root user privileges.

Installing Linux agent

  1. Install development tools and compilers. In Linux this can easily be done using your distribution’s package manager:
  1. For RPM-based distributions:
# yum install make gcc
  1. For Debian-based distributions:
# apt-get install gcc make libc6-dev curl
  1. Download and extract the latest version:
$ curl -Ls https://github.com/wazuh/wazuh/archive/3.1.tar.gz | tar zx
  1. Run the install.sh script. This will run a wizard that will guide you through the installation process using the Wazuh sources:
# cd wazuh-*
# ./install.sh

Note

You can also run an unattended installation.

  1. The script will ask about what kind of installation you want. Type agent in order to install a Wazuh agent:
1- What kind of installation do you want (manager, agent, local, hybrid or help)? agent

Note

Now that the agent is installed, the next step is to register and configure it to communicate with the manager. For more information about this process, please visit the user manual.

Installing Windows agent

This section describes how to download and build the Wazuh HIDS Windows agent from sources. This process begins with compiling the agent on a Linux system to generate the .msi installer for the Windows installation.

Note

The following procedure has been tested on Ubuntu 16.04 and other Debian based distributions and may work with other Debian/Ubuntu versions as well.

  1. Set up the Ubuntu build environment. Install these dependencies to build the Windows Wazuh agent installer on Ubuntu:
# apt-get install gcc-mingw-w64
# apt-get install nsis
# apt-get install make
  1. Set up Windows build environment. To generate the installer, the following dependencies must be in place on the Windows machine:
  • WiX Toolset.
  • .NET framework 3.5.1.
  • Microsoft Windows SDK.
  1. Download the Wazuh source code and unzip it:
# curl -Ls https://github.com/wazuh/wazuh/archive/3.1.tar.gz | tar zx
# cd wazuh-*/src
  1. Compile the agent by running the make command:
# make TARGET=winagent

The following output will appear at the end of the building process:

Done building winagent
  1. Once the agent has been compiled, transfer the Wazuh folder to the target Windows system. It is recommended that this folder be compressed at first to speed up the process.
# zip -r wazuh.zip ../../wazuh-3.1
  1. Once in Windows, run the wazuh-3.1/src/win32/wazuh-installer-build-msi.bat file to start the installer generation. If you do not want to sign the installer, you will have to comment or delete the signtool line.

Note

The installer is now ready. It can be launched with a normal or unattended installation. For more information about this process, please visit our installation section for Windows.

Note

Once the agent is installed, the next step is to register and configure it to communicate with the manager. For more information about this process, please visit the user manual.