Help Center/ ModelArts/ Image Management/ Creating a Custom Image/ Creating a Custom Image for a Notebook Instance/ Creating a Custom Image
Updated on 2026-07-27 GMT+08:00
View PDF
Share

Creating a Custom Image

When using ModelArts for machine learning, you may need to customize your development environment. This includes tasks like installing, upgrading, or uninstalling software. However, you cannot install software that requires root access because the notebook instance does not have these permissions. To solve this issue, you can use ModelArts images or third-party images. Write Dockerfiles to create custom development environment images that fit your needs. This allows for efficient customization.

Base image: a basic concept in image creation. You can create service images based on base images. A base image can be a ModelArts preset image or a unified image.

Process for Creating a Custom Image

Scenario 1: Create a notebook instance using a ModelArts preset image or custom image, install custom software and dependencies on the notebook instance, and save the running instance environment as a container image. For details, see Creating a Custom Image Using the Image Saving Function.

Scenario 2: Build and register an image based on the preset image or third-party image in a notebook instance, configure the Docker environment on the server, and compile the Dockerfile. For details, see Creating a Custom Image on ECS and Using It.

Specifications for Custom Images

The base image for creating a custom image must meet either of the following conditions:

  • It is an open-source image from the official website of Ascend or Docker Hub and it meets the following OS constraints:

    x86: Ubuntu 22.04 or Ubuntu20.04

    ARM: EulerOS 2.10.x, EulerOS 2.9.x, EulerOS 2.8.x, HCE 3.0, or HCE 2.0

  • If an image error occurs due to unmet requirements, check the image specifications and rectify the fault by referring to Troubleshooting for Custom Images in Notebook Instances. If the fault persists, contact technical support.
Parent Topic: Creating a Custom Image for a Notebook Instance