Deploy A Honeypot!

Why deploy your own honeypot with HoneyDB?
  • Easy setup, easy data collection
  • Access to the data via HoneyDB's REST API
  • Sharing your honeypot data with HoneyDB benefits the broader community
  • You benefit from others sharing their honeypot data with HoneyDB.
To get started, follow the outline below...

Getting Started

First you should determine where you want to install and run your honeypot. Any Internet facing environment, options include:
Next, determine which honeypot package you want to run. There are two options:
  • HoneyPy (Download) - Requires Python and some knowledge of setting up and running Python applications, documentation here.
  • HoneyDB Agent (Download) - Python not required, no knowledge of setting up and running Python applications. Run the binary or install with a Linux package manager. There are packages for Amazon Linux, CentOS, Red Hat, Ubuntu, and Debian on x86_64. You can also run the agent on your Raspberry Pi (Raspbian armv6l and armv7l). Windows is supported as well.

Finally, to send honeypot data to HoneyDB you'll need to configure your honeypot with your HoneyDB API ID key and HoneyDB Agent/HoneyPy Sensor API key. To obtain these keys you need to sign-in here.

One-Click Deployment Options

  • On Heroku you can deploy a free instance quickly and easily, for details visit Deploy to Heroku - note: this deployment option only supports the HTTP plugin.
  • On DigitalOcean you can deploy a cloud instance quickly and easily, for details visit DigitalOcean's Marketplace.

Getting Data

Once you have the HoneyDB Agent up and running, you can use the HoneyDB CLI tool to download your honeypot data.
See more details about the API here. Another good tool to work with the API is Postman.