Custom Containers Deployment

Deploy a Custom Container Image

The Custom image option allows you to deploy a container from an external public or private registry. Repository credentials can be stored securely so the platform can authenticate during deployment, scaling and redeployment.

In this article

Open the Custom Image Section

1

Open the environment wizard

Click New Environment or open the topology settings of an existing environment.

2

Select a custom container layer

Switch to the Custom topology tab, select the required layer and click Select Image.

3

Open the Custom tab

In the image selector, choose the Custom tab to review saved images or add a new repository.

Custom container image selector
Open the Custom tab in the container image selector.

Add a Repository Image

1

Click Add New Image

Select Add New Image in the Custom tab.

2

Enter the repository path

Provide the image repository using the registry hostname and repository name.

registry.example.com/team/application

For Docker Hub images, the registry hostname may be omitted when the standard Docker Hub registry is used.

✓

Tag selection

You usually do not need to add the tag while saving the repository. The required tag can be selected when the image is added to the topology.

Add a custom container repository image
Enter the registry and repository details for the custom image.

Configure Private Registry Credentials

When the image is stored in a protected repository, provide the registry username and password before adding the image.

Public repositoryLeave the username and password fields empty.
Private repositoryEnter valid registry credentials that have permission to pull the image.
Stored credentialsThe platform reuses the credentials for future scaling and redeployment operations.
!

Use a registry account with limited permissions

Where possible, use read-only credentials that can pull images but cannot modify or delete repository content.

Private container registry credentials
Enter registry credentials when the image repository is private.

Select and Deploy the Image

1

Add the image

Click Add after entering the repository information and credentials.

2

Select the image tag

Choose the required version from the available tag list.

3

Add the image to the layer

Select the image and continue to the environment topology.

4

Configure and create the environment

Set the required resources, scaling, variables, links, volumes, ports and run configuration, then click Create or Apply.

Select a custom container image tag
Choose the required image tag before adding it to the topology.
i

Separate images require separate layers

A single container layer can use only one image. Add another layer when the environment requires a different image or service.

Manage Saved Custom Images

Saved repositories remain available in the Custom tab for future deployments. Depending on the available controls, you can select the image, mark it as a favorite or remove it from the saved list.

If private repository credentials change after deployment, update them from the existing container layer settings using the repository credentials action.

Select imageAdds the saved repository and selected tag to a container layer.
FavoriteKeeps frequently used images easily accessible.
RemoveDeletes the saved repository entry from the Custom image list.
Update credentialsReplaces expired or changed private-registry login information for an existing layer.

Expected Result

The selected public or private repository image is added to the custom image list and deployed as a managed container. The platform can use the stored credentials during future scaling, restart and redeployment operations.

Important Notes

  • Verify the complete registry and repository path before adding an image.
  • Use valid pull credentials for private repositories.
  • Select an image tag compatible with your application configuration and data.
  • Review required ports, variables, volumes and startup commands before deployment.
  • Use separate layers for different container images.
  • Update stored credentials before they expire or are revoked.

Common Issues and Solutions

Repository cannot be foundCheck the registry hostname, organization name and repository path for spelling errors.
Authentication failsConfirm that the username and password are valid and have permission to pull the image.
No image tags are displayedVerify repository access and confirm that the registry exposes the required tags.
Container starts but the application is unavailableReview ports, environment variables, volumes and the CMD / Entry Point configuration.
Scaling or redeployment fails laterUpdate the repository credentials if the stored password or access token has changed.

Related Guides