Skip to content

Latest commit

 

History

History
28 lines (21 loc) · 1.38 KB

readme.md

File metadata and controls

28 lines (21 loc) · 1.38 KB
Raw

OpenCanary Installation and Configuration Wrapper

OpenCanary is a configurable open-source honeypot solution provided by Thinkst. This wrapper script helps install and configure your OpenCanary appliance using sane defaults, including:

  • Setting the device's hostname
  • Updating the OS
  • Configuring unattended upgrades for OS and application patches
  • Installing dependencies
  • Installing and configuring the canary
  • Creating a systemd unit file to launch OpenCanary as a service

Pre-requisites

  • Ubuntu or Debian based Linux distribution with Systemd
  • Network connection

Installation Instructions

For more detailed installation instructions, see my post.

  1. Copy or download the 'opencanary-installer.sh' to your home directory
  2. Modify the permissions of the file to allow execution using sudo chmod +x opencanary-installer.sh
  3. Run the installer using sudo ./opencanary-installer.sh
  4. After the script automatically triggers a reboot, your device should be operating as a Canary

Troubleshooting

  1. Confirm the Canary service is running by entering systemctl status opencanary. You should see a returned value that includes Active: active (running)
  2. Ensure your configuration file at ~/opencanary.conf is valid
  3. Look for error messages at /var/tmp/opencanary.log