PAGES
← all tools
◆ Container & Image Security

Clair

v4.9.0 open-source

Performs static analysis of vulnerabilities in OCIOCIOpen Container Initiative standard, maintained by the Linux Foundation, defining the image format and runtime spec that container tools share so images built once run anywhere OCI-compliant. and Docker container images via an API for indexing and matching.

Summary

Clair is an open-source, Apache 2.0-licensed tool for static analysis of vulnerabilities in container images, covering both OCI and Docker formats. It runs as a service with an API: clients submit an image to be indexed, then match that index against known vulnerabilities, rather than running Clair as a one-off CLI scan. This suits platform and security teams building vulnerability scanning into a registry or container pipeline rather than developers wanting a quick local check. Its README ties it closely to Quay, the container registry it was built to back, positioning it as infrastructure for registry-level scanning rather than a standalone desktop tool. First committed in 2015, it remains active with 181 contributors and 139 commits over the past year, though the most recent release was 254 days ago.

Performs static analysis of vulnerabilities in OCI and Docker container images via an API for indexing and matching.

How Clair helps

Which vulnerabilities are present in an image before it reaches a registry?

indexes the image's contents through the API and matches that index against known vulnerability data, returning the matches rather than requiring a manual scan step

Which of my container images share a vulnerable package?

since indexing is decoupled from matching, the same stored index can be re-matched whenever vulnerability data updates, surfacing every image built on that package without re-scanning each one

Has a new vulnerability disclosure made an already-published image unsafe?

re-runs matching against the existing index when the vulnerability database changes, so images already indexed are re-checked without resubmitting them

Are my images built from OCI or Docker formats both covered by the same scanning pipeline?

accepts both formats through the same indexing and matching API, so a single service backs scanning regardless of which spec an image follows

Can my registry or pipeline get vulnerability answers without a local scan tool on every machine?

runs as a standing service with an API that clients call to submit images and retrieve match results, so the scanning logic lives centrally rather than on each developer's machine

all 12 features, with the evidence for each →

Languages

Not documented

Features

12 capabilities across 3 capability groups · 1 backed by code, an API document or a real run

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

  • Clair covers 2 of the 8 vulnerability assessment methods capabilities we track.
  • Clair covers 1 of the 5 supply chain security capabilities we track.

What Clair offers you

  • Command-line interface1
Vulnerability database matching 2 features Vulnerability assessment methods since 2016
Vulnerability indexing improvements (OSV, Debian, CPE) shipped Improves the accuracy of vulnerability parsing for OSV advisories and Debian source packages, adds NIST CPE 2.3 name matching, and supports dynamic discovery for SUSE distributions. 8 releases · first seen May 2017

Shared capability: Vulnerability database matching

release 8 total

  • Adds dynamic discovery support for suse.linux.enterprise.server and opensuse.leap distributions v4.9.0 · Dec 2025 · source · release history
  • Adds NIST IR 7696 CPE2.3 Name Matching support for CPE pattern matching v4.8.0 · Oct 2024 · source · release history
  • Improves OSV advisory parsing to extract severity from .database_specific when the native .severity object is missing. v4.7.4 · May 2024 · source · release history
  • Updates Debian updater logic to correctly record source packages instead of relying on inaccurate metadata heuristics. v4.7.4 · May 2024 · source · release history
  • RPM indexers support PGP V4 signatures v4.7.3 · Feb 2024 · source · release history
  • rhel and rhcc indexers can now use compressed local files for data storage v4.7.3 · Feb 2024 · source · release history
Vulnerability data source support (CSAF/VEX and NVD 2.0) shipped Supports ingesting Red Hat security data via CSAF/VEX formats with configurable timeouts, and enriches vulnerabilities using NVD 2.0 JSON feeds. 7 releases · first seen Mar 2016

Shared capability: Vulnerability database matching

release 7 total

  • Adds updaters.config.rhel-vex.compressed_file_timeout config key to control the download timeout for RHEL VEX archives v4.9.0 · Dec 2025 · source · release history
  • Switches CVSS enrichment from NVD 1.1 to NVD 2.0 JSON feeds v4.9.0 · Dec 2025 · source · release history
  • Adds csaf/vex updaters for Red Hat security data, replacing the deprecated RHEL OVAL v2 updaters v4.8.0 · Oct 2024 · source · release history
  • Add support for S3 registries using V4 signature to clairctl v4.0.6 · Jun 2021 · source · release history
  • clairctl can now connect to S3 registries using V4 signatures. v4.1.1 · Jun 2021 · source · release history
  • Supports scanning vulnerabilities in Ubuntu 20.04 OS families v2.1.4 · Jun 2020 · source · release history
Container image vulnerability scanning 1 feature Vulnerability assessment methods since 2016
App Container Image (ACI) scanning support shipped Enables the vulnerability scanning of App Container Images in addition to standard container images. 3 releases · first seen Mar 2016

Shared capability: Container image vulnerability scanning

release

  • Adds Oracle Linux Security Database source to enable vulnerability detection on Oracle Linux systems. v2.0.0 · May 2017 · source · release history
  • Adds apk format and Alpine-SecDB source to enable vulnerability detection on Alpine Linux systems. v2.0.0 · May 2017 · source · release history
  • Adds ACI (App Container Image) support for vulnerability scanning v1.0.0 · Mar 2016 · source · release history
SPDX SBOM 1 feature Supply chain security since 2016
Configuration and export capabilities (IgnoreUnpatched, SPDX) shipped Adds configuration options to ignore unpatched vulnerabilities for RHEL matchers and enables SPDX 2.3 document encoding for index reports. 3 releases · first seen Apr 2016

Shared capability: SPDX SBOM

release

  • Adds SPDX-2.3 document encoding capability for index reports via a new encoder v4.9.0 · Dec 2025 · source · release history
  • Adds IgnoreUnpatched config key to the RHEL matcher (moved from updater) v4.8.0 · Oct 2024 · source · release history
  • Adds /etc/clair/config.yml as the default configuration file location v1.1.0 · Apr 2016 · source · release history
Other / not yet classified 8 features Features we have not matched to a capability yet. A suggested match is marked.
Quay registry pruning verified Queries and deletes images from a Quay registry in paginated batches, with controls for page size, page count, and a dry-run mode to preview deletions without making any changes. 3 releases · 3 other sources · first seen Apr 2016

release

  • Adds updaters.config.rhel-vex.compressed_file_timeout config key to control the download timeout for RHEL VEX archives v4.9.0 · Dec 2025 · source · release history
  • Adds O_TMPFILE fallback logic in libindex so Clair handles deployments that do not support the O_TMPFILE flag. v4.7.4 · May 2024 · source · release history
  • Enables HTTP_PROXY environment variable support in the webhook notifier v1.1.0 · Apr 2016 · source · release history

command line

  • --n — dry-run: do not issue delete requests v4.8.0 · Oct 2024 · command-line history
  • --page-count — only process `N` pages before stopping (-1 for "all") v4.8.0 · Oct 2024 · command-line history
  • --page-size — pull pages of `SIZE` from the Quay database v4.8.0 · Oct 2024 · command-line history
Clair state management via CLI shipped suggested Provides an admin subcommand in clairctl for managing internal Clair state, including the deletion of specific vulnerability sources. 3 releases · first seen Mar 2016

Suggested capability: Container image vulnerability scanning. This is our guess, not confirmed.

Also counts toward: Command-line interface

release

  • Adds clairctl -D admin pre v4.8.0 subcommand to manually clean deprecated OVAL vulnerabilities v4.8.0 · Oct 2024 · source · release history
  • admin subcommand to clairctl for managing Clair state (e.g., deleting pyupio vulns). v4.7.0 · Jul 2023 · source · release history
  • Introduces a stable, general-purpose RESTful JSON API for interaction v1.0.0 · Mar 2016 · source · release history
Iterator-based database updates for memory efficiency shipped Provides iterator interfaces (`UpdateVulnerabilitiesIter`, `UpdateEnrichmentsIter`) to allow custom updaters to perform database operations with reduced memory consumption. 1 release · 1 other source · first seen Oct 2024

release

  • Extends Updater interface with UpdateVulnerabilitiesIter method and EnrichmentUpdater with UpdateEnrichmentsIter for iterator-based database updates v4.8.0 · Oct 2024 · source · release history

example

  • Implement custom updaters using the new iterator interfaces to reduce memory consumption during database updates func (u *MyUpdater) UpdateVulnerabilitiesIter(ctx context.Context, iter Iterator) error { // Use iter instead of returning a slice } v4.8.0 · Oct 2024 · source
Garbage collection observability shipped Visualizes deletion-related metrics and monitors the health of garbage collection processes using contrib Grafana dashboards. 1 release · 1 other source · first seen Oct 2023

release

  • Adds contrib Grafana dashboards that visualize deletion-related metrics exposed by the API v4.7.2 · Oct 2023 · source · release history

example

  • Monitor the health and progress of garbage collection using the new contrib dashboards Import contrib/grafana/dashboards/deletion-metrics.json into your Grafana instance v4.7.2 · Oct 2023 · source
Pre-migration database cleanup shipped Allows manual execution of pre-migration cleanup to remove deprecated OVAL vulnerabilities before automatic migration processes. 1 other source · first seen Oct 2024

example

  • Run pre-migration cleanup manually before the automatic database migration removes old OVAL data clairctl -D admin pre v4.8.0 v4.8.0 · Oct 2024 · source
Minimum TLS version enforcement shipped Enforces a minimum TLS version for server connections, currently restricted to 1.2, to secure network communications. 1 release · first seen Feb 2024

release

  • Minimum TLS version for Clair servers is enforced to 1.2 v4.7.3 · Feb 2024 · source · release history
Container readiness and liveness health checks shipped Provides the ability to probe the liveness and readiness state of the running container. 1 release · first seen May 2021

release

  • Enables the readiness endpoint in the introspection service to allow probing container liveness. v4.1.0 · May 2021 · source · release history
Vulnerability database update control shipped Allows users to disable automatic vulnerability database updates through configuration options. 1 release · first seen Mar 2021

release

  • Adds the DisableUpdaters option to allow users to disable automatic vulnerability database updates. v4.0.4 · Mar 2021 · 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 Clair, 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 Clair 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

15 entries

  1. December 20251
  2. October 20241
  3. May 20241
  4. February 20241
  5. October 20231
  6. July 20231
  7. November 20221
  8. June 20212
  9. May 20211
  10. March 20211
  11. June 20201
  12. May 20171
  13. April 20161
  14. March 20161
    Show

    15 entries

    Project health

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

    1. Contributors 14 +7 vs prior 12 months
    2. Maintainers 3 +0 joined · −0 left, last 12 months
    3. Bus factor 2 committers behind half the commits
    4. Community-filed 100% of issues opened, last 12 months
    5. Median time to close 10 days first maintainer reply 1.6 hours
    6. Open backlog 19 of 683 issues ever filed
    1. Issues opened / month 0 · 0 communitymaintainers
    2. Open backlog 19
    3. Contributors / month 1
    4. Commits / month 1
    5. Stars 11,057
    Issue themes, last 12 months
    • other 100%

    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

    Libraries its release ships

    What its latest release locks, checked against known advisories.

    None of its release's images build from a lockfile we can read.

    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 →