Knowledge base

Docker Image Discovery

Last Updated: 2026-11-17



Purpose

This article describes how to set up a Docker Image Discovery scan.

Introduction

A Docker image is a file used to execute code in a Docker container. Docker images act as a set of instructions to build a Docker container, like a template. Docker images also act as the starting point when using Docker. An image is comparable to a snapshot in virtual machine (VM) environments.

The Docker Image Discovery feature scans private Docker registries using the Docker Registry HTTP API V2 to enumerate images, capturing details like name, operating system, architecture, and size for latest tagged images. Integrated with OUTSCAN RC and a HIAB container inspection scanner, it catalogs Docker assets under the Cloudsec source filter in the Assets section. This tool is vital for organizations to maintain a clear inventory of container images, enhancing security and management of Docker environments.

Requirements

To access a private registry, a Docker account with its credentials is required.

When scanning a Docker image using OUTSCAN RC, a HIAB deployed as a container inspection scanner is required. For more information, see Use Appsec Scale with OUTSCAN RC

Run a Docker Image Discovery Scan

Prerequisite

Prior to running a Docker discovery, make sure you have created the Docker credentials.

Running the Scan

A Docker Registry discovery function retrieves image information from a private Docker Registry such as name, OS, architecture and size.

The discovery finds one image for each repository in the registry: the image with the latest tag or, if the repository has no latest tag, the image with the last tag in the list the registry returns. Images with other tags are not discovered.

To perform a Docker discovery:

  1. Go to Configuration > Scan configurations in the Main Menu.

  2. Click the + button in the bottom right corner.

  3. Select Docker image discovery.

  4. Select the Credentials of the registry.

    Portal_Scanning_DockerDiscovery_New.png
  5. Choose a scanner.

  6. Click Add to save the configuration.

  7. Select the scan configuration in the list and click Scan now Icon_scan_now_selection_bar.png in the toolbar at the bottom of the page.

    Portal_Scanning_Configurations_SelectionBar.png
  8. View the scan status under Scans in the Main Menu.

  9. View the discovered images under Assets > Assets. Docker images have the source Cloudsec.

    Portal_Scanning_DockerDiscovery_Assets.png