Product documentation
Citrix SecurSpaces™
View PDF

Container images

September 18, 2026
Contributed by: 
T

Container images or also Cloud Development Environments (CDEs) are used to define the configuration of a development environment. Typically, CDEs define all the software dependencies necessary for building the intended application once implemented. Users create workspaces with such an image as “blueprint”, and begin contributing code to the project within this context.

CDE images are imported from a registry as part of the resources available to users on the platform. Registries are either public or private. For private registries, you need to provide credentials to authenticate properly before importing the image. Public registries, by definition, do not need credentials.

View CDE Images

The panel displays the available CDE images in the project. You may search for one or filter those used in workspaces.

containers-view-light

A CDE image is defined by the following characteristics:

  • Basic information: Name, scope of use (platform, organization or project), URL and tag.
  • Class Level: This option defines the visibility for the CDE image based on the user’s permissions.
  • Asset Information: This option allows for providing a description of the CDE.

By clicking on a CDE image, you can see a list of the CDE’s versions followed by basic details such as imported date, status.

Add a CDE Image

Requires the Resources permission set to Import.

Select Add Image. The form opens as New Workspace Image and asks for:

  1. URL, the full path to the image, in the form <registry>/<namespace>/<repository>:<tag>.
  2. Image Name, a name to identify the image.
  3. Image Tag, for example v1.0.0.
  4. Private Registry (optional), the credential used to reach a private registry.
  5. Attach Asset Information (optional), a description of the image.

add-image

Warning

The image must meet the SecurSpaces container image requirements before it can be used for a workspace. At minimum it needs an SSH client, Git and Git LFS, and a user named developer with UID 1000. For the full list, see Container image requirements.

You can edit or delete a CDE image by clicking on the “…” icon next to its class level.

View Registry Credentials

To display credentials used in the project click on the “Credentials” button on the top right of the panel. You may search for one or filter those used in workspaces.

credentials-view

A Registry Credential is defined by the following characteristics:

  1. Name,
  2. Scope and
  3. a URL.

For security purpose, no credentials are directly exposed or available for consultation.

Add a Registry Credential

Requires the Security permission set to Manage.

You can add a Registry Credential by pressing the “Add Registry Credential” button.

add-credentials

You will need to enter the following information:

  1. Name, to identify the credentials when needed during the registration of a CDE image,
  2. Username:, and
  3. Password:, as credential values, and an
  4. URL: where the authentication is performed.
  5. Asset information, a description of the registry credential.

Update a Registry Credential

When a registry credential becomes invalid, a red key icon will be displayed next to the related container image, as shown in the screenshot below.

update-credentials

Hover over the icon to reveal the name of the credential, then switch to the Credentials view by clicking on the respective tab in the top right corner. Find the credential that was identified before in the list of stored credentials and click on the “…” button on the right. Select Update to update the credential information.

update-credentials

Container images
September 18, 2026
Contributed by: 
T
September 18, 2026
Contributed by: 
T

In this article

Site feedback | Your privacy choices footer linkYour Privacy Choices | Privacy and legal terms | Cookie preferences | Consent settings | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.