Install Wazuh agent from sources

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


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 | tar zx
  1. Run the script, this will display a wizard that will guide you through the installation process using the Wazuh sources:
# cd wazuh-*
# ./


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)? manager


At this point your agent is installed and you just need to register and configure it to talk to your manager. For more information about this process please visit our user manual.

Installing Windows agent

This section describes how to download and build the Wazuh HIDS Windows agent from sources. First of all, we will compile the agent on a Linux system to end up generating the .msi installer on Windows.


The following procedure has been tested to work with Ubuntu 16.04 and other Debian based distributions as building environment, may work fine with other Debian/Ubuntu versions as well.

Set up 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

Set up Windows build environment

To generate the installer we need to solve the following dependencies in Windows:

  • WiX Toolset.
  • .NET framework 3.5.1 or higher.
  • Microsoft Windows SDK.

Source code download

Download the Wazuh source code and unzip it:

# curl -Ls | tar zx
# cd wazuh-*/src

Compiling the agent

Run the make command:

# make TARGET=winagent

You should expect the following output at the end of the building process:

Done building winagent

Once the agent has been compiled, we should transfer the src folder to a Windows system. This folder could be compressed at first to speed up the process.

# zip -r ../src *

Once in Windows, we only need to run src/win32/wazuh-installer-build-msi.bat to start the installer generation. If we don’t want to sign the installer, we will have to comment or delete the signtool line.


At this point the installer is ready. You can launch it with a normal or unattended installation. For more information about this process please visit our installation section for Windows.