Private Container Registries

The platform supports images hosted in private container registries for both scenarios:

Using as a base image in your Dockerfile for the build process.
Deploying directly as described here.

In either case, you must configure the registry credentials on the platform to securely access the images during deployments.

To configure these credentials, navigate to your organization's Settings page and locate the Container Registries section. Here, you can create, edit, and delete container registry configurations as needed.

Required Information:

Provide the following details when configuring credentials:

Field	Description	Example
Display Name	A friendly name to easily identify your registry.	`My Org Private Registry`
Address	The address of your registry.	`my-registry.com`
Auth Type	Authentication type. Supported values: `BasicAuth` or `Token`.	`BasicAuth` or `Token`
Credentials	Depending on the authentication method selected:
	- BasicAuth: Provide a Username & Password	Username/password
	- Token: Provide a long-lived token	Token string

Warning

Ensure the credentials provided are long-lived, as the platform does not support automatic credential refresh.

Note

If the image was deployed prior to configuring the credentials, you may need to restart the deployment for changes to take effect.

More details about private registry authentication can be found here.