OpenCanary

OpenCanary is a multi-protocol network honeypot.

  • Network Services
  • Tools & Utilities
OpenCanary is a multi-protocol network honeypot. Its primary use-case is to catch hackers after they've breached non-public networks. It has extremely low resource requirements and can be tweaked, modified, and extended. The following services are enabled by default: telnet ssh http https

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

70/100 Good

Maintained
88last commit 24 days ago
Popular
703,092 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data

Based on 3 of 4 factors.

Availability: platform listings confirmed today, links checked 41 days ago

GitHub stars
3,092
Open issues
8
Last commit
2026-10-27
Latest release
v0.9.10
License
BSD-3-Clause
Activity
declining

Checked 17 days ago - source: GitHub (thinkst/opencanary)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Set up and test the main daemon Create and edit the config with `opencanaryd --copyconfig`, check it with `jq . ~/.opencanary.conf`, start it with `opencanaryd --start`, try a decoy login such as `ftp localhost`, and confirm an entry appears in `/var/tmp/opencanary.log`. Without a valid config and a quick test, OpenCanary may not run or may silently miss the scans it is supposed to record. source
  • Choose the fake services and ports In `~/.opencanary.conf`, turn on only the decoy services you want, for example SSH (port 22) or MySQL (port 3306), and set each port to the number you want that fake service to listen on. If a service is disabled or its port is blocked, scanners will never reach that decoy and you will not get alerts for it. source
  • Optional: add the correlator If you want OpenCanary to combine related events, make sure Redis (a simple in-memory database) is running and start `opencanary-correlator --config=./opencanary-correlator.conf`. Without it, the canary still records detections, but they remain separate log entries instead of correlated alerts. source
  • Dedicated IP Address Assign a dedicated IP address to the OpenCanary container to avoid port conflicts with other services on the same network segment. source

Fetched 45 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

How can I verify OpenCanary is running and logging decoy attempts?

Create or edit the config with opencanaryd --copyconfig, start it with opencanaryd --start, then test a decoy login such as ftp localhost. Confirm the attempt appears in /var/tmp/opencanary.log, because a missing or invalid config can cause it to miss scans silently.

How do I choose which fake services OpenCanary exposes?

Enable only the decoy services you want in ~/.opencanary.conf and set the port for each one, such as SSH on 22 or MySQL on 3306. A disabled service or blocked port will not be reached by scanners and will not generate alerts.

Why might Dockerized OpenCanary report the wrong attacker IP?

Dockerized OpenCanary must run on a Linux-based OS, not Windows or macOS, to report the correct attacker IP. The Docker setup also needs the host parameter specified.

How interactive is OpenCanary's SSH decoy compared with Cowrie?

A user reports that OpenCanary's SSH service may only provide a login interface. This is noted as unlike Cowrie.

Answers sourced from github.com, opencanary.readthedocs.io, opencanary.readthedocs.io, www.reddit.com

Community

Collected 48 days ago - public community threads