[![GitHub Release][release-img]][release] [![Test][test-img]][test] [![Go Report Card][go-report-img]][go-report] [![License: Apache-2.0][license-img]][license] [![GitHub Downloads][github-downloads-img]][release] ![Docker Pulls][docker-pulls] [📖 Documentation][docs]
Trivy ([pronunciation][pronunciation]) is a comprehensive and versatile security scanner. Trivy has *scanners* that look for security issues, and *targets* where it can find those issues. Targets (what Trivy can scan): - Container Image - Filesystem - Git Repository (remote) - Virtual Machine Image - Kubernetes Scanners (what Trivy can find there): - OS packages and software dependencies in use (SBOM) - Known vulnerabilities (CVEs) - IaC issues and misconfigurations - Sensitive information and secrets - Software licenses Trivy supports most popular programming languages, operating systems, and platforms. For a complete list, see the [Scanning Coverage] page. To learn more, go to the [Trivy homepage][homepage] for feature highlights, or to the [Documentation site][docs] for detailed information. ## Quick Start ### Get Trivy Trivy is available in most common distribution channels. The full list of installation options is available in the [Installation] page. Here are a few popular examples: - `brew install trivy` - `docker run aquasec/trivy` - Download binary from - See [Installation] for more Trivy is integrated with many popular platforms and applications. The complete list of integrations is available in the [Ecosystem] page. Here are a few popular examples: - [GitHub Actions](https://github.com/aquasecurity/trivy-action) - [Kubernetes operator](https://github.com/aquasecurity/trivy-operator) - [VS Code plugin](https://github.com/aquasecurity/trivy-vscode-extension) - See [Ecosystem] for more ### Canary builds There are canary builds ([Docker Hub](https://hub.docker.com/r/aquasec/trivy/tags?page=1&name=canary), [GitHub](https://github.com/aquasecurity/trivy/pkgs/container/trivy/75776514?tag=canary), [ECR](https://gallery.ecr.aws/aquasecurity/trivy#canary) images and [binaries](https://github.com/aquasecurity/trivy/actions/workflows/canary.yaml)) generated with every push to the main branch. Please be aware: canary builds might have critical bugs, so they are not recommended for use in production. ### General usage ```bash trivy [--scanners ] ``` Examples: ```bash trivy image python:3.4-alpine ```
Result https://user-images.githubusercontent.com/1161307/171013513-95f18734-233d-45d3-aaf5-d6aec687db0e.mov
```bash trivy fs --scanners vuln,secret,misconfig myproject/ ```
Result https://user-images.githubusercontent.com/1161307/171013917-b1f37810-f434-465c-b01a-22de036bd9b3.mov
```bash trivy k8s --report summary cluster ```
Result ![k8s summary](docs/imgs/trivy-k8s.png)
## FAQ ### How to pronounce the name "Trivy"? `tri` is pronounced like **tri**gger, `vy` is pronounced like en**vy**. ## Want more? Check out Aqua If you liked Trivy, you will love Aqua which builds on top of Trivy to provide even more enhanced capabilities for a complete security management offering. You can find a high level comparison table specific to Trivy users [here](https://trivy.dev/docs/latest/commercial/compare/). In addition check out the website for more information about our products and services. If you'd like to contact Aqua or request a demo, please use this form: ## Community Trivy is an [Aqua Security][aquasec] open source project. Learn about our open source work and portfolio [here][oss]. Contact us about any matter by opening a GitHub Discussion [here][discussions] Please ensure to abide by our [Code of Conduct][code-of-conduct] during all interactions. [test]: https://github.com/aquasecurity/trivy/actions/workflows/test.yaml [test-img]: https://github.com/aquasecurity/trivy/actions/workflows/test.yaml/badge.svg [go-report]: https://goreportcard.com/report/github.com/aquasecurity/trivy [go-report-img]: https://goreportcard.com/badge/github.com/aquasecurity/trivy [release]: https://github.com/aquasecurity/trivy/releases [release-img]: https://img.shields.io/github/release/aquasecurity/trivy.svg?logo=github [github-downloads-img]: https://img.shields.io/github/downloads/aquasecurity/trivy/total?logo=github [docker-pulls]: https://img.shields.io/docker/pulls/aquasec/trivy?logo=docker&label=docker%20pulls%20%2F%20trivy [license]: https://github.com/aquasecurity/trivy/blob/main/LICENSE [license-img]: https://img.shields.io/badge/License-Apache%202.0-blue.svg [homepage]: https://trivy.dev [docs]: https://trivy.dev/docs/latest/ [pronunciation]: #how-to-pronounce-the-name-trivy [code-of-conduct]: https://github.com/aquasecurity/community/blob/main/CODE_OF_CONDUCT.md [Installation]:https://trivy.dev/docs/latest/getting-started/installation/ [Ecosystem]: https://trivy.dev/docs/latest/ecosystem/ [Scanning Coverage]: https://trivy.dev/docs/latest/coverage/ [alpine]: https://ariadne.space/2021/06/08/the-vulnerability-remediation-lifecycle-of-alpine-containers/ [rego]: https://www.openpolicyagent.org/docs/latest/#rego [sigstore]: https://www.sigstore.dev/ [aquasec]: https://aquasec.com [oss]: https://www.aquasec.com/products/open-source-projects/ [discussions]: https://github.com/aquasecurity/trivy/discussions