trivy
Comprehensive security vulnerability scanner
TLDR
Scan a container image for vulnerabilities
SYNOPSIS
trivy [global options] command [command options] target
DESCRIPTION
Trivy is a comprehensive security scanner developed by Aqua Security. It detects vulnerabilities in OS packages and application dependencies, infrastructure misconfigurations, exposed secrets, and software license issues.
Trivy supports multiple targets including container images, filesystems, git repositories, virtual machine images, and Kubernetes clusters. It integrates with CI/CD pipelines and can output results in various formats for different tools and platforms.
The vulnerability database is automatically downloaded and cached. Trivy can generate Software Bill of Materials (SBOM) in CycloneDX and SPDX formats, and can also scan existing SBOM files for known vulnerabilities.
PARAMETERS
image, i
Scan a container image for vulnerabilities.filesystem, fs
Scan a local filesystem or directory.repository, repo
Scan a remote git repository.config, conf
Scan configuration files for misconfigurations.kubernetes, k8s
Scan a Kubernetes cluster.rootfs
Scan a root filesystem (e.g., extracted container image).sbom
Scan an SBOM file for vulnerabilities.server, s
Run Trivy in server mode.plugin, p
Manage Trivy plugins.--severity levels
Comma-separated list of severity levels to show: UNKNOWN, LOW, MEDIUM, HIGH, CRITICAL.--format format
Output format: table, json, sarif, template, cyclonedx, spdx, spdx-json, github.--output file
Write results to a file.--ignore-unfixed
Only show vulnerabilities that have a fix available.--pkg-types types
Comma-separated list of package types to scan.--scanners scanners
Comma-separated list of scanners: vuln, misconfig, secret, license.--cache-dir dir
Specify cache directory for database.-q, --quiet
Suppress progress bar and log output.-d, --debug
Enable debug mode.-v, --version
Display version information.-h, --help
Display help message.
CAVEATS
The vulnerability database download requires internet access on first run. For air-gapped environments, the database can be pre-downloaded and specified via --cache-dir or hosted on a private OCI registry. Container image scanning requires a working container runtime or access to the registry.
HISTORY
Trivy was created by Teppei Fukuda and first released in 2019 as a container vulnerability scanner. It was acquired by Aqua Security in 2019 and has since expanded to become a comprehensive security scanner. In 2023, tfsec (Terraform security scanner) was merged into Trivy, consolidating Aqua's open-source security tools. Trivy has become one of the most widely adopted open-source vulnerability scanners.
