> See the full index of documentation pages at https://docs.zettabyte.com/llms.txt.

# Container images

> Store a registry login and create an image from Images in the console of zCLOUD, the GPU cloud, then find the fields that take an image on the training task and web IDE forms.

Source: https://docs.zettabyte.com/docs/zcloud/compute/container-images

Last updated: 2026-11-05

A container image, also called a Docker image, holds the software a task starts from: the operating system files, the libraries and the code.

## Before starting

To store a login for a private registry, have these values ready:

- A name for the entry, for **Repository Name**
- The registry's address, for **Repository Address**
- A user name, for **User Name**
- A password or token, for **Password / Token**

## Add a registry credential

The **External Credentials** tab holds keys or Docker credentials for third-party image registries.

1. Open [**Images**](https://console.zettabyte.com/library-image/list) from the zCLOUD console menu.
2. Select the **External Credentials** tab.
3. Select **Create External Credential**.
4. Fill **Repository Name**, **Repository Address**, **User Name** and **Password / Token**. All four are required.
5. Optional: enter a **Description**.
6. Select **Create External Credential**. The entry appears in the **External Credentials** list, with the registry's address under **Repository Address**.

Each entry's row menu has **Edit**, which opens **Edit External Credential** with the same five fields, and **Delete**, which asks for confirmation before it removes the entry.

## Create an image

The **Create Image** drawer requires **Image Directory**, **Image Name & Version**, **As Latest** and **Build Method**, and **Tags** is optional.

1. Open [**Images**](https://console.zettabyte.com/library-image/list) from the zCLOUD console menu.
2. Select the **Image Registry** tab.
3. Select **Create Image**. The **Create Image** drawer opens.
4. In **Image Directory**, select an entry.
5. In **Image Name & Version**, enter a name and a version, one in each box.
6. Optional: under **Tags**, select **Add Tag**.
7. Under **Build Method**, select **Dockerfile**, **IDE** or **Tasks**.
8. Select **Create Image**.

## Use an image in a task or web IDE

The training task form and the web IDE form each have fields that take an image.

Open [**Training**](https://console.zettabyte.com/task-training/index) for the task list. **Create Task** there opens the **Create Training Task** form, which shows an **Image Directory** field of its own.

Open [**IDE**](https://console.zettabyte.com/task-ide/index) for the web IDE list. **Create IDE** there opens the **Create Web IDE** form. With **Advanced Settings** on, step 1 of the form shows **Custom Image**.

## Next steps

- [Run a training job](https://docs.zettabyte.com/docs/zcloud/tasks/run-a-training-job): when the image is ready, to fill in the rest of the **Create Training Task** form.
- [Notebooks and IDEs](https://docs.zettabyte.com/docs/zcloud/compute/notebooks-and-ides): to start a web IDE.
- [Models, images, and storage](https://docs.zettabyte.com/docs/zcloud/cli/models-images-and-storage): to work with images and saved registry credentials from a terminal with `zb image`.
