PAGES
← all tools
◆ Malware Analysis

YaraHunter

v2.5.7 open-source

YaraHunter scans container images, running Docker containers, and filesystems to find indicators of malware using a YARA ruleset.

Summary

YaraHunter is an open-source malware-scanning tool, distributed under its own GitHub license, that checks container images, running Docker containers, and filesystems against YARA rulesets to find indicators of compromiseindicators of compromiseAn indicator of compromise, an observable clue that may point to malicious activity, such as a suspicious file hash or domain. It is evidence to investigate, rather than proof by itself.. It runs as a command-line tool, distributed as a Docker container for portability, and produces JSON output meant to be parsed by other automation rather than read directly, which fits it into CI/CD build pipelines as well as ad hoc runtime checks. It is aimed at security and DevOps teams responsible for verifying build artifacts and live containers rather than at endpoint or network defenders. It sits in the malware-analysis category and is described in its own README as a work in progress that will eventually be folded into Deepfence's ThreatMapper platform. Since its first commit in 2022, it has drawn 20 contributors and seen 11 commits and 10 releases in the past year, so development continues at a modest but steady pace.

YaraHunter scans container images, running Docker containers, and filesystems to find indicators of malware using a YARA ruleset.

How YaraHunter helps

Does this container image contain files matching known malware signatures?

runs the YARA ruleset against every file in the image and lists each match by rule name and file path, before the image is deployed anywhere

Is a running container showing signs of compromise right now?

scans the live filesystem of the container against the same YARA ruleset and reports matches, useful when unusual network or CPU activity raises suspicion

Did a build artifact pick up malware during the CI/CD pipeline?

scans the built image or filesystem as a pipeline step and emits JSON results a build script can check before allowing the artifact to ship

Where exactly in a file does an indicator of compromise sit?

reports the byte offset of each match alongside the rule and file name, so a match can be located without re-scanning by hand

Is a suspect file itself the threat, or just a config or script that happened to match?

can scan non-executable files such as scripts, documents and configs as well as binaries, though by default it skips non-executable files to cut noise, so that coverage depends on turning the default back off

Can a filesystem be checked for compromise without packaging it as a container?

points the same YARA-based scan directly at a local filesystem and returns the same match report, independent of any image or running container

all 11 features, with the evidence for each →

Languages

Not documented

Features

11 capabilities · 2 backed by code, an API document or a real run

Built from YaraHunter'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 →

  • YaraHunter covers 1 of the 8 investigation and response capabilities we track.

What YaraHunter offers you

  • Command-line interface2
  • JSON data export1
All capabilities 11 capabilities
Enhanced scan precision and performance shipped Improves scanning accuracy and efficiency by supporting archive scanning, providing byte offsets for IoCs, and optimizing file handling. 3 releases · first seen Jul 2024

Shared capability: Threat indicator matching

release

  • Supports scanning non-executable files (e.g. scripts, documents, configs) in addition to binaries. v2.5.7 · Apr 2025 · source · release history
  • Supports scanning tar archives directly. v2.3.0 · Jul 2024 · source · release history
  • Adds byte offsets for each indicator of compromise (IoC) found, making it easier to pinpoint exact match locations in files. v2.3.0 · Jul 2024 · source · release history
Structured output formatting shipped Provides consistent JSON output for scan results, configurable log verbosity, and detailed status information to facilitate integration with other systems. 3 releases · first seen Sep 2023

Also counts toward: JSON data export

release

  • Makes status output configurable. v2.3.0 · Jul 2024 · source · release history
  • Allows optional updater with a new configuration to disable the mandatory malware scan upgrade step. v2.0.1 · Oct 2023 · source · release history
  • Changes output format to JSON for both file output and stdout v2.0.0 · Sep 2023 · source · release history
CLI log level control verified Lets the user set the verbosity of CLI output by choosing a log level (error, warn, info, or debug), filtering out messages below the chosen level. 2 other sources · first seen Apr 2025

command line

  • --log-level — Log levels are one of error, warn, info, debug. Only levels higher than the log-level are displayed v2.5.7 · Apr 2025 · command-line history

example

  • Scan container image, output JSON results docker run -i --rm --name=deepfence-yarahunter \
File type optimization shipped Automatically optimizes scan performance by skipping non-executable files by default while allowing explicit scanning of them when required. 2 releases · first seen Nov 2024

release

  • Automatically skips non-executable files during scans to reduce noise and improve scan performance. v2.5.0 · Nov 2024 · source · release history
  • The default behavior for scanning non-executable files has changed: skip_non_executable is now set to true, meaning non-executable files are skipped by default where they were previously scanned. v2.5.0 · Nov 2024 · source · release history
Product variant selection verified Allows the user to specify which Deepfence product (ThreatMapper or ThreatStryker) the CLI targets, via a flag or environment variable. 2 other sources · first seen Nov 2024

Also counts toward: Command-line interface

command line

  • --product — Deepfence Product type can be ThreatMapper or ThreatStryker, also supports env var DEEPFENCE_PRODUCT v2.5.0 · Nov 2024 · command-line history

example

  • Extract matched rule names from scan output cat /tmp/xmrig-scan.json | jq '.IOC[] | ."Matched Rule Name"'
Direct rule updates shipped suggested Enables the CLI to download and update YARA rules directly without requiring a separate management step. 1 release · first seen Nov 2024

Suggested capability: Threat indicator matching. This is our guess, not confirmed.

Also counts toward: Command-line interface

release

  • Adds YARA rules download capability directly in CLI mode, enabling rule updates without a separate management step. v2.5.0 · Nov 2024 · source · release history
Network proxy support shipped Configures the tool to route outbound traffic through a proxy server for secure or restricted network environments. 1 release · first seen Nov 2024

release

  • Supports proxy server configuration for environments where outbound traffic is routed through a proxy. v2.5.0 · Nov 2024 · source · release history
Container runtime flexibility shipped Supports alternative container runtimes like Podman alongside Docker for scanning operations. 1 release · first seen Oct 2023

release

  • Adds podman support as an alternative container runtime. v2.0.1 · Oct 2023 · source · release history
Scan job management shipped Allows users to control the lifecycle of active scanning tasks, including stopping them while they are running. 1 release · first seen Sep 2023

release

  • Adds API endpoint or mechanism to stop active scan jobs v2.0.0 · Sep 2023 · source · release history
Scan result distribution shipped Publishes scan findings to external systems, such as Kafka topics, for downstream processing. 1 release · first seen Sep 2023

release

YARAHunter server mode shipped Enables running YARAHunter as a standalone HTTP server for remote scanning capabilities. 1 release · first seen Sep 2023

release

  • Adds support for running YaraHunter as a standalone HTTP server v2.0.0 · Sep 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 YaraHunter, 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 YaraHunter 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

Show

5 entries

  1. April 20251
  2. November 20241
  3. July 20241
  4. October 20231
  5. September 20231
    Show

    5 entries

    Project health

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

    1. Contributors 1 −3 vs prior 12 months
    2. Maintainers 1 +0 joined · −1 left, last 12 months
    3. Bus factor 1 committers behind half the commits
    4. Community-filed not measured of issues opened, last 12 months
    5. Median time to close not measured issues closed, last 12 months
    6. Open backlog 6 of 19 issues ever filed
    1. Issues opened / month 0 · 0 communitymaintainers
    2. Open backlog 6
    3. Contributors / month 0
    4. Commits / month 0
    5. Stars 1,319
    Issue themes, last 12 months not measured

    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 →