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

Linux and Unix agents

Open a session in your Linux/Unix agent host as root user. After that, you can register the Agent using agent-auth and a password as follows:

  1. Register the agent using the password. The agents can use the password by storing it on a file or as a command line argument, so you can use any of these two options:
  1. Write the password on /var/ossec/etc/authd.pass and run the agent-auth program:
# echo "TopSecret" > /var/ossec/etc/authd.pass
# /var/ossec/bin/agent-auth -m <MANAGER_IP_ADDRESS>
  1. Run the program with the -P flag, and insert the password:
# /var/ossec/bin/agent-auth -m <MANAGER_IP_ADDRESS> -P "TopSecret"
  1. Edit the Wazuh agent configuration to add the Wazuh server IP address.

In the file /var/ossec/etc/ossec.conf, in the <client><server> section, change the MANAGER_IP value to the Wazuh server address:

<client>
  <server>
    <address>MANAGER_IP</address>
    ...
  </server>
</client>
  1. Start the agent.
  1. For Systemd:
# systemctl start wazuh-agent
  1. For SysV Init:
# service wazuh-agent start
  1. Other cases:
# /var/ossec/bin/ossec-control start