Setup

This page may be used to get up and running with the HoneyTrap framework.

Installing HoneyTrap Sensor

This page describes the steps to take in order to install the HoneyTrap Sensor:

The installation procedure is very similar to the one for installing HoneyTrap Agent and HoneyTrap Server. Basicly, when running HoneyTrap in Sensor Mode, all requests are sent to the ouput channel directly.

Install docker and Docker Compose

The installation of HoneyTrap is relying on Docker and Docker Compose. Useful information for installing these applications can be found in this section. HoneyTrap is not able to run within a Docker container, since it is based on a custom network stack. Nevertheless, it is still usefull to install Docker and Docker Compose if you want to log and analyze the generated data locally. By following this guide, an Elastic Search and Kibana container will be configured. Optionally, one may log to an external (Elastic Search) source or to console as well.

Setup the prerequisites

In order to start the installation, the are some prerequisites you have to comply with. All necessary inforamtion can be found in this section.

Run Docker Compose

This step will explain the necessary steps you need to take in order to run the Docker Compose.

What’s next