OpenCanary
OpenCanary is a multi-protocol network honeypot.
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
Variants
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
- Anyone running OpenCanary? : r/sysadmin - Reddit (reddit)
- Understanding OpenCanary : r/AskNetsec - Reddit (reddit)
- What is the best open source honeypot? [Need Experiences] - Reddit (reddit)
- Suggestions for Canary token alternative : r/blueteamsec - Reddit (reddit)
- Does anyone have OpenCanary working in a docker container? (reddit)
- r/selfhosted on Reddit: Got OpenCanary up and running in docker, but ... (reddit)
Collected 48 days ago - public community threads