Installing Trivy

In this section you will find an aggregation of the different ways to install Trivy. installations are listed as either "official" or "community". Official integrations are developed by the core Trivy team and supported by it. Community integrations are integrations developed by the community, and collected here for your convenience. For support or questions about community integrations, please contact the original developers.

Install using Package Manager

RHEL/CentOS (Official)

RepositoryRPM

Add repository setting to /etc/yum.repos.d.

cat << EOF | sudo tee -a /etc/yum.repos.d/trivy.repo
[trivy]
name=Trivy repository
baseurl=https://aquasecurity.github.io/trivy-repo/rpm/releases/\$basearch/
gpgcheck=1
enabled=1
gpgkey=https://aquasecurity.github.io/trivy-repo/rpm/public.key
EOF
sudo yum -y update
sudo yum -y install trivy

rpm -ivh https://github.com/aquasecurity/trivy/releases/download/v0.57.1/trivy_0.57.1_Linux-64bit.rpm

Debian/Ubuntu (Official)

RepositoryDEB

Add repository setting to /etc/apt/sources.list.d.

sudo apt-get install wget gnupg
wget -qO - https://aquasecurity.github.io/trivy-repo/deb/public.key | gpg --dearmor | sudo tee /usr/share/keyrings/trivy.gpg > /dev/null
echo "deb [signed-by=/usr/share/keyrings/trivy.gpg] https://aquasecurity.github.io/trivy-repo/deb generic main" | sudo tee -a /etc/apt/sources.list.d/trivy.list
sudo apt-get update
sudo apt-get install trivy

wget https://github.com/aquasecurity/trivy/releases/download/v0.57.1/trivy_0.57.1_Linux-64bit.deb
sudo dpkg -i trivy_0.57.1_Linux-64bit.deb

Homebrew (Official)

Homebrew for MacOS and Linux.

brew install trivy

Windows (Official)

1. Download trivy_x.xx.x_windows-64bit.zip file from releases page.
2. Unzip file and copy to any folder.
3. Ensure PATH environment variable is configured to folder trivy installed.

Arch Linux (Community)

Arch Linux Package Repository.

sudo pacman -S trivy

References: - https://archlinux.org/packages/extra/x86_64/trivy/ - https://gitlab.archlinux.org/archlinux/packaging/packages/trivy/-/blob/main/PKGBUILD

MacPorts (Community)

MacPorts for MacOS.

sudo port install trivy

References: - https://ports.macports.org/port/trivy/details/

Nix/NixOS (Community)

Nix package manager for Linux and MacOS.

Command lineConfigurationHome Manager

nix-env --install -A nixpkgs.trivy

# your other config ...
environment.systemPackages = with pkgs; [
  # your other packages ...
  trivy
];

# your other config ...
home.packages = with pkgs; [
  # your other packages ...
  trivy
];

References:

• https://github.com/NixOS/nixpkgs/blob/master/pkgs/tools/admin/trivy/default.nix

FreeBSD (Official)

Pkg for FreeBSD.

pkg install trivy

asdf/mise (Community)

asdf and mise are quite similar tools you can use to install trivy. See their respective documentation for more information of how to install them and use them:

• asdf
• mise

The plugin used by both tools is developped here

asdfmise

A basic global installation is shown below, for specific version or/and local version to a directory see "asdf" documentation.

# Install plugin
asdf plugin add trivy https://github.com/zufardhiyaulhaq/asdf-trivy.git

# Install latest version
asdf install trivy latest

# Set a version globally (on your ~/.tool-versions file)
asdf global trivy latest

# Now trivy commands are available
trivy --version

A basic global installation is shown below, for specific version or/and local version to a directory see "mise" documentation.

# Install plugin and install latest version
mise install trivy@latest

# Set a version globally (on your ~/.tool-versions file)
mise use -g trivy@latest

# Now trivy commands are available
trivy --version

Install from GitHub Release (Official)

Download Binary

1. Download the file for your operating system/architecture from GitHub Release assets.
2. Unpack the downloaded archive (tar -xzf ./trivy.tar.gz).
3. Make sure the binary has execution bit turned on (chmod +x ./trivy).
4. Put the binary somewhere in your $PATH (e.g sudo mv ./trivy /usr/local/bin/).

Install Script

The process above can be automated by the following script:

curl -sfL https://raw.githubusercontent.com/aquasecurity/trivy/main/contrib/install.sh | sudo sh -s -- -b /usr/local/bin v0.57.1

Install from source

git clone --depth 1 --branch v0.57.1 https://github.com/aquasecurity/trivy
cd trivy
go install ./cmd/trivy

Use container image

1. Pull Trivy image (docker pull aquasec/trivy:0.57.1)
2. It is advisable to mount a consistent cache dir on the host into the Trivy container.
3. For scanning container images with Trivy, mount docker.sock from the host into the Trivy container.

Example:

docker run -v /var/run/docker.sock:/var/run/docker.sock -v $HOME/Library/Caches:/root/.cache/ aquasec/trivy:0.57.1 image python:3.4-alpine

Registry	Repository	Link	Supportability
Docker Hub	docker.io/aquasec/trivy	https://hub.docker.com/r/aquasec/trivy	Official
GitHub Container Registry (GHCR)	ghcr.io/aquasecurity/trivy	https://github.com/orgs/aquasecurity/packages/container/package/trivy	Official
AWS Elastic Container Registry (ECR)	public.ecr.aws/aquasecurity/trivy	https://gallery.ecr.aws/aquasecurity/trivy	Official

Other Tools to use and deploy Trivy

For additional tools and ways to install and use Trivy in different environments such as in IDE, Kubernetes or CI/CD, see Ecosystem section.