PAGES
← all tools
◆ Detection Engineering

OpenCanary

v0.9.10 open-source

OpenCanary is a multi-protocol network honeypot that alerts you when attackers breach non-public networks and interact with its services.

Summary

OpenCanary is an open-source, free multi-protocol network honeypot daemon that mimics services like MySQL, MSSQL, and MongoDB so it can alert on attacker interactions after a network breach, running as a lightweight background process with low enough resource needs to sit on a Raspberry Pi or a small VM. It suits blue teams and detection engineers who want tripwires inside a network rather than at its perimeter, configured per host as a Linux web server, Windows server, or database box, with alerts sent to syslog, email, HTTP webhooks, or a companion correlator that merges repeated events like brute-force attempts into one notification. Its README describes it as the open-source counterpart to Thinkst's commercial Canary product. First committed in 2015 and still active, with 65 contributors and a release cut just 30 days ago.

OpenCanary is a multi-protocol network honeypot that alerts you when attackers breach non-public networks and interact with its services.

How OpenCanary helps

Has anyone touched the fake database or file share I set up as bait?

each canary service logs the connection attempt with source IP, timestamp, and credentials tried, and sends an alert through whichever channel is configured

Is someone quietly probing this network before I notice anything else is wrong?

the daemon sits on the host mimicking real services, so any interaction at all is inherently unauthorized and worth an alert, catching lateral movement that perimeter tools never see

Am I about to get buried in alerts from one attacker retrying a login?

repeated related events, like a string of brute-force attempts, can be routed to the companion correlator which merges them into a single notification instead of one per attempt

Which of my machines should look like a database server versus a web server versus a Windows box?

the config file enables only the protocol modules matching that host's personality, so a MySQL or MSSQL box presents matching fake services while a web server or Windows server presents different ones

Is anyone scanning this specific host's ports rather than just hitting one service?

the optional portscan module watches for scan activity against the host itself and can alert on that separately from the service honeypots

Where do these alerts actually end up so my team sees them?

alerts can be written to syslog or local logs, emailed directly, posted to an HTTP webhook, or forwarded to the correlator, depending on which output is configured

all 6 features, with the evidence for each →

Languages

Not documented

Features

6 capabilities · 1 backed by code, an API document or a real run

Built from OpenCanary's releases, docs, README and our own runs. “Seen” marks the month we first spotted a release the vendor didn't date. Group names and tags are our labels.

Compare with peers →

What OpenCanary offers you

  • Command-line interface
All capabilities 6 capabilities
macOS launchctl service installation verified Installs and runs OpenCanary as a named macOS launchd service, with configurable service name and log output directory. 2 releases · 5 other sources · first seen May 2023

release

  • New MongoDB honeypot module enables detection of unauthorized database connection attempts. v0.9.8 · May 2026 · source · release history
  • Updates MS Teams webhook format to keep alert notifications working with current Teams API. v0.9.8 · May 2026 · source · release history

command line

  • --canary v0.9.0 · May 2023 · command-line history
  • --service-name — string you would like launchctl to use as the name of the opencanary service v0.9.0 · May 2023 · command-line history
  • --log-output-dir — opencanary will write its logs to files in DIR when the service is running v0.9.0 · May 2023 · command-line history

example

  • Enable the MongoDB honeypot to detect attackers probing for exposed database instances. { "mongo.enabled": true, "mongo.port": 27017 } v0.9.8 · May 2026 · source
  • Start honeypot with dropped privileges opencanaryd --start --uid=nobody --gid=nogroup
Module connection limits shipped Allows configuring the maximum number of concurrent connections for specific honeypot modules. 2 releases · first seen Sep 2026

release

Network interface binding shipped Allows individual services to be explicitly bound to a specific network interface. 1 release · first seen Mar 2024

release

  • Adds the listen_addr configuration key to OpenCanary modules, allowing practitioners to explicitly bind individual services to a specific network interface. v0.9.3 · Mar 2024 · source · release history
Detection event filtering shipped Filters detection events by code type to refine honeypot alerts. 1 release · first seen Oct 2023

release

  • Adds ignore.codetype config parameter to filter detection events by code type v0.9.1 · Oct 2023 · source · release history
Port scan filtering shipped Ignores specific ports during port scan detection to reduce false positives. 1 release · first seen Oct 2023

release

  • Adds ignore.ports config key to specify ports to ignore during port scans v0.9.1 · Oct 2023 · source · release history
SSH honeypot algorithm support shipped Detects SSH interactions using specific key algorithms like rsa-sha2-512 and rsa-sha2-256. 1 release · first seen Oct 2023

release

  • Adds support for rsa-sha2-512 and rsa-sha2-256 SSH key algorithms in the Honeypot module v0.9.1 · Oct 2023 · source · release history

Lines in monospace are the tool's own words: help text parsed from its source, or an endpoint from its API document. Under release, a line is our summary of a dated release. Under docs, it is quoted from the tool's own documentation or website. Each links back to the source it came from.

Score card

  1. Shipping velocity releases a month, last 12 months
  2. Documentation quality release-notes rubric, 0–100
  3. Breaking-change discipline how rarely a release breaks users, and notice given
  4. Maintenance risk quiet time against its own cadence, maintainers
  5. Innovation & surface new capabilities, API and MCP surface
  6. Community health
  7. Contributor trend distinct committers, this year against last
  8. Maintainer concentration bus factor now against a year ago
  9. Issue backlog trend issues closed per issue opened, 12 months
  10. Responsiveness median time to a maintainer’s first reply

Nine scores for OpenCanary, each built from the releases, notes and API history this site tracks — and, on Researcher and Business, where it stands among every measured tool in its category and how that has moved.

Score cards are part of every paid plan.

See plans →

Each score is 0–100 on a published rubric, derived from data this site already shows. A dimension we cannot measure says so — it is never scored 0 and never enters a rank.

How this is scored
  • Shipping velocity — releases a month over the last 12 months, on a log scale where 16 a month scores 100. Needs 3 releases in the window.
  • Documentation quality — the release-notes rubric published on the analytics page, unchanged.
  • Breaking-change discipline — the share of releases carrying a breaking change (none scores 100, half or more scores 0). Only projects that label breaking changes are measured: a clean record cannot be told from an unlabelled one.
  • Maintenance risk — quiet time measured against the tool's own release cadence (quiet longer than 90 days and three typical gaps scores 0), plus the number of active maintainers and whether contributors are growing, where known. Higher is lower risk.
  • Innovation & surface — new capabilities in the feature ledger this year, API and MCP operations added, and the share of commits that are features: the mean of whichever we hold.
  • Community health (open-source tools only) — each is a direction, not a size: contributors this year against last, the bus factor now against a year ago, and issues closed per issue opened, where steady scores 50, doubled 100 and halved 0; plus the median time to a maintainer's first reply (an hour scores about 100, a month or more 0). A commercial card has no repository and carries none of the four.
  • Documented delivery (commercial tools) — when a vendor's documented new capabilities have slowed against its own baseline, that counts against the overall standing as heavily as two low dimensions. Steady delivery, or too little history to judge, leaves the standing alone; it is never a sixth score.
  • Open-source tools are scored on repository signals; commercial tools on their published changelog. Ranks compare tools within one category and one profile and need at least five measured peers; the overall standing needs three ranked dimensions. Best-in-breed or consolidator is a shape, not a quality, and is never scored.

Release-note detail over time

See how much detail OpenCanary puts in its release notes, quarter by quarter, and compare it with tracked tools in the same category. This history uses up to ten retained, reviewed notes per tool; sparse or blank older quarters may reflect that limit.

Checking release-note history…

Explore the full chart →

Releases

6 entries

  1. September 20261
  2. July 20261
  3. May 20261
  4. October 20241
  5. March 20241
  6. October 20231

    6 entries

    Project health

    Issue, contributor and maintainer activity in thinkst/opencanary, 2023-10 – 2026-09, as of 2026-09-25. Twelve-month figures first; the trend lines run the whole window.

    1. Contributors 11 +4 vs prior 12 months
    2. Maintainers 2 +2 joined · −2 left, last 12 months
    3. Bus factor 1 committers behind half the commits
    4. Community-filed 100% of issues opened, last 12 months
    5. Median time to close 28 days first maintainer reply 28 days
    6. Open backlog 1 of 231 issues ever filed
    1. Issues opened / month 0 · 0 communitymaintainers
    2. Open backlog 1
    3. Contributors / month 4
    4. Commits / month 9
    5. Stars 3,035
    Issue themes, last 12 months
    • bugs 88%
    • features 12%

    Counts from the project's public repository and git history; no individuals are identified. Maintainers are the committers covering 80% of the last year's commits. how we measure this

    Add the badge to your README

    Maintain this project? The badge links readers straight to this page, so they can follow every release here.

    Tracked by Cyber Toolchain Choose a badge style and copy the code →
    browse all tools → score card for your toolchain →