Skip to content

Overview

Trivy can download images from a private registry without the need for installing Docker or any other 3rd party tools. This makes it easy to run within a CI process.

Credential

To use Trivy with private images, simply install it and provide your credentials:

$ TRIVY_USERNAME=YOUR_USERNAME TRIVY_PASSWORD=YOUR_PASSWORD trivy image YOUR_PRIVATE_IMAGE

Trivy also supports providing credentials through CLI flags:

$ TRIVY_PASSWORD=YOUR_PASSWORD trivy image --username YOUR_USERNAME YOUR_PRIVATE_IMAGE

Warning

The CLI flag --password is available, but its use is not recommended for security reasons.

You can also store your credentials in trivy.yaml. For more information, please refer to the documentation.

It can handle multiple sets of credentials as well:

$ export TRIVY_USERNAME=USERNAME1,USERNAME2
$ export TRIVY_PASSWORD=PASSWORD1,PASSWORD2
$ trivy image YOUR_PRIVATE_IMAGE

In the example above, Trivy attempts to use two pairs of credentials:

  • USERNAME1/PASSWORD1
  • USERNAME2/PASSWORD2

Please note that the number of usernames and passwords must be the same.

docker login

If you have Docker configured locally and have set up the credentials, Trivy can access them.

$ docker login ghcr.io
Username: 
Password:
$ trivy image ghcr.io/your/private_image

Note

docker login can be used with any container runtime, such as Podman.