Welcome to HoneyDB Agent Docs!

Documentation Status

HoneyDB (honeydb.io) provides real time data of honeypot activity. This data comes from honeypot sensors deployed globally on the Internet.

HoneyDB Agent

The honeydb-agent is a small honeypot program that can be easily deployed on Linux or Windows systems. The honeydb-agent can be configured to particpate in the HoneyDB network or operate standalone. When running as a standalone agent all activity can be logged to local files, but the primary purpose for the honeydb-agent is to contribute log data back to the HoneyDB website. The honeydb-agent can implement numerous network service emulations (plugins). The level of interaction is determined by the functionality of the plugins.

When configured to contribute log data to HoneyDB, all data are accessible via the HoneyDB REST API. This means you can deploy the honeydb-agent quickly with minimal configuration effort and no requirement for log management.

Installation

Install packages are hosted by Cloudsmith.io, current version:

Latest Version @ Cloudsmith

Linux

On Linux, the honeydb-agent can be installed via your package management system. First, you will need to add the honeydb-agent repository to your system, then it can be installed via package management tools (e.g apt-get or yum).

Instructions for adding the honeydb-agent package repository to you system can be found on the HoneyDB website. For each operation system there is a Quick Setup and Manual Setup option.

Amazon Linux / Red Hat / CentOS

Debian

Ubuntu

Raspbian (ARM)

Windows

Win32

OSX

OSX