Updated on 2025-07-30 GMT+08:00

Pushing an Image

Scenarios

You can use either a container engine client or the SWR console to push your images to SWR for easier management.

  • Method 1: Run docker push (Docker) or ctr push (containerd) on the server where the container engine client is installed to push an image to SWR. This is applicable to the push of large images.

    The push can be implemented over an intranet or the Internet. For details, see Configuring Access Network.

  • Method 2: Upload an image on the SWR console. This is applicable to the push of small images.

Prerequisites

Constraints

  • If a Docker container engine client is used to push images, the Docker version is 18.06 or later.
  • The size of each image layer cannot exceed 10 GB.
  • A single tenant can push a maximum of 20 image layers concurrently.
  • If you use the console, a maximum of 10 files can be uploaded at a time. The size of a single file (including the decompressed files) cannot exceed 2 GB. If the image package to be uploaded is created using a Docker container engine client, the Docker version is 18.06 or later.

Methods

For small images, upload them on the console. Resumable upload is not supported. For large images, push them using a container engine client.

The number of images that can be stored in SWR is not limited. You can push as many images as you want.

FAQ

Why Does an Image Fail to Be Pushed Using a Container Engine Client?

Other

Procedure

  1. Log in to the SWR console.
  2. In the navigation pane, choose My Images. Then click Upload Through SWR.
  3. In the displayed dialog box, select an organization. Then, click Select File to upload an image file.

    If you select multiple images, they will be uploaded one by one. Concurrent upload is not supported.

    Figure 2 Uploading an image on the SWR console

  4. Click Upload.

    If Completed is displayed, the image is uploaded successfully.

FAQ

Why Does an Image Fail to Be Uploaded Through the SWR Console?

Other