# Custom Images

### Create a Custom Image

1. Go to **\[Container List]**.
2. Select the target container you’ve already set up. Make sure you have write your Python scripts in Code Server
3. Click the **\[Create Custom Image]** button at the top of the list

<figure><img src="https://359648826-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FczvFDRUHYgwRH0wSxo3t%2Fuploads%2FY6p4kMbZvcPabRcx3taY%2F1.png?alt=media&#x26;token=a2df2430-a028-4998-9769-0169b2d8ac8b" alt=""><figcaption></figcaption></figure>

4. Fill in the Image Details in the setup panel:

* **Image Tag:** A version or identifier (e.g., `v1.0`).
* **Description:** Optional notes about the environment.
* **Image Type:**
  * 🔒 **Private** – Only visible to you
  * 👥 **Project** – Shareable with all project members

5. Click **\[Create]** to save your image.
6. Once created, your image will appear under:

   **Image Management → Custom Image List**

   From there, you can:

   * ✅ Launch containers based on this image
   * 🧪 Create jobs or job templates
   * 🔎 Search or filter images by tag, type, or name

***

### Create Container or Job/Template from Custom Image

1. Go to **Custom Image List**.
2. Click the `⋮` (three-dot menu) on the image card.
3. Select **\[Create Container] / \[Create Job] / \[Create Job Template]**.
4. The image will be pre-selected in the container wizard.

> 🧠 You can still modify hardware specs, mount volumes, etc.

<figure><img src="https://359648826-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FczvFDRUHYgwRH0wSxo3t%2Fuploads%2FDIErfiJdzM6W9KlhrX9s%2F2.png?alt=media&#x26;token=ca1fa71b-8a23-411f-8af9-a4fca53495ee" alt=""><figcaption></figcaption></figure>

***

### Edit or Delete Custom Images

* To **edit**, click `⋮` → **Edit Image**
  * Update name, tag, or description
* To **delete**, click `⋮` → **Delete Image**
  * Confirm deletion in the popup

> ⚠️ **Caution:** Deleted images **cannot** be recovered.

***

### 💡 Pro Tip

Use custom images as "base environments" for standardized training, demos, or team-wide development environments. Combine with batch container creation for streamlined onboarding!

The **Custom Image** feature allows users to save their personalized container environments — including installed packages and configurations — for future reuse or sharing within a project.

{% embed url="<https://youtu.be/MDNfO9lcPIg?si=Dr0tg7k1U7nlt3_6>" %}
