Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.
Cortex XSIAM

Pull Docker images from a private image registry

Pull private registry images for Cortex XSIAM.

Pulling images from a private image registry enables securely accessing and deploying content, for example, custom integrations containing scripts and code packaged into Docker images. You can then run the integrations and scripts.

Before you begin

  • Before pulling a custom image ensure the image does not infringe any licenses.

  • If using an engine, connect the engine to the private image registry using Docker or Podman. See Connect an engine to an image registry.

(Multi-tenant) This feature is not supported on the Main Account.

Configure image registry

  1. Go to Settings → Configurations → General → Image Registry.

  2. Set Use Additional Private Image Registry to On.

  3. Configure access to the private image registry and the images to pull.

    1. Select Connection, then select Direct or Using Engine.

    2. Define the Registry URL.

      Set the registry URL to your organization registry service hostname, such as us-central1-docker.pkg.dev.

    3. If you selected Using Engine, select the engine to use. Authentication is set on the engine machine, not in the tenant. For an example, see Connect an engine to an image registry.

    4. If you selected Direct, set the Username and Password/Access Token.

  4. Select Test to verify the registry connection.

  5. Define Import images in name:tag format. For example: myimage:2.7.18.24398.

  6. Add, edit, or remove images. If you do not specify a tag, the default latest tag is added automatically.

    If you use folders to store images, include the folder path in the image name, such as myorg/python:latest. Only one folder is supported. Subfolders are not supported.

    The demisto/ prefix cannot be used for custom registry images.

  7. Select Save to save the configuration and start synchronization.

Image synchronization

When you click Save or Update Docker Images, Cortex XSIAM performs synchronization, which involves:

  • Pulling the images from the external registry.

  • Copying and storing the images on the platform.

  • Updating the engines with the new images.

The synchronization process may take time. The Image Registry page displays synchronization status (for example in progress, complete, failure).

If the engine fails to synchronize, it may be offline. When it goes back online, it will pull any new images when running scripts or integrations that use them.

Last updated

Was this helpful?