For the complete documentation index, see llms.txt. This page is also available as Markdown.

Docker Registry / Distribution

Docker Registry / Distribution is a self-hosted Docker Registry V2-compatible registry that organizations run in their own environments. Connecting Docker Registry / Distribution to OX enables OX to discover and scan container images stored in your private registry and surface container security findings alongside the rest of your application security results.

Unlike the Docker Hub connector, which connects to the Docker SaaS platform, the Docker Registry / Distribution connector supports registries hosted and managed within your own environment.

Prerequisites

Before connecting Docker Registry / Distribution to OX, ensure that:

  • You have permission to configure integrations in OX.

  • Your Docker Registry / Distribution instance is accessible from OX.

  • You have a Docker Registry account with permissions to access the repositories that you want OX to scan.

  • You know the following connection details:

    • Docker Registry host URL

    • Username

    • Password

Note

If your registry is hosted in a private network or behind a firewall, allow connectivity from OX to the registry or configure an OX Broker.

Connect OX to Docker Registry / Distribution

  1. In OX, go to Settings > Connectors.

  2. Select Add Connection.

  3. Select Docker Registry / Distribution.

Enter the connection details.

Parameter
Description

Docker Registry / Distribution Host URL

The URL of your Docker Registry instance. For example: https://registry.example.com.

User Name

The username used to authenticate to the registry.

Password

The password associated with the registry account.

Connection Name

A descriptive name for the connection in OX.

  1. Select Verify Connectivity.

  2. Select Connect.

  3. Open the connection configuration.

  4. Select the repositories that you want OX to monitor and scan.

  5. Select Save.

After the connection is established, OX scans the selected repositories and continuously monitors them for container security findings. Findings are available throughout the OX platform, including Active Issues, Applications, dashboards, reports, and workflows.

Last updated