This is unreleased documentation for SBOM Scanner 0.13-dev.

Common problems

This page documents common errors that occur while users run SBOM Scanner. It explains how to correct these errors.

Docker Hub pull rate limit reached

Problem

Scans end up in an error state with a message similar to:

You have reached your unauthenticated pull rate limit

This happens because anonymous image pulls from Docker Hub (docker.io) are subject to rate limiting. Once the limit is hit, further pulls are rejected until the window resets.

See the official Docker documentation for full details:

Solution

Authenticate with Docker Hub. Then pulls count against your account limits instead of the shared anonymous quota. See the Docker documentation for available options:

After you get credentials, create a kubernetes.io/dockerconfigjson Secret in the SBOM Scanner installation namespace. Reference the Secret from the applicable Registry resource. To propagate credentials to managed registries, set the authSecret field in WorkloadScanConfiguration. See Private Registries for the procedure.