Uploading a custom OS image

You can add a custom OS or software product image to install it on your server on your own. To proceed, first upload your image file to the Yandex Object Storage bucket.

Uploading an image file to Object StorageUploading an image file to Object Storage

Upload the ISO image to Yandex Object Storage and get a link to the uploaded object:

1. Create an Object Storage bucket:

   Note

   To create a bucket, you need the minimum storage.editor role for the folder.

   Management console

   Yandex Cloud CLI

   1. In the management console, select the folder where you want to create a bucket.

   2. Go to Object Storage.

   3. At the top right, click Create bucket.

   4. On the bucket creation page:

      1. Enter a name for the bucket as per the naming conventions.
      2. Set a bucket size limit or enable No limit, if required.
      3. Leave all other parameters as they are and click Create bucket.

   If you do not have the Yandex Cloud CLI installed yet, install and initialize it.

   By default, the CLI uses the folder specified when creating the profile. To change the default folder, use the yc config set folder-id <folder_ID> command. You can also set a different folder for any specific command using the --folder-name or --folder-id parameter.

   1. Create a bucket in the default folder:

      yc storage bucket create --name <bucket_name>
      

      Where --name is the name of the bucket. This is a required parameter. For more information, see Bucket naming rules.

      Result:

      name: <bucket_name>
      folder_id: b1gt6g8ht345********
      anonymous_access_flags: {}
      default_storage_class: STANDARD
      versioning: VERSIONING_DISABLED
      created_at: "2025-08-06T07:29:40.418079Z"
      resource_id: e3e9neva43dl********
      

      For more information about the yc storage bucket create command, see the Yandex Cloud CLI reference.

2. Upload the downloaded image file to the created bucket.

   Management console

   Yandex Cloud CLI

   Note

   You can upload objects of up to 5 GB via the management console (see Quotas and limits in Object Storage). To upload larger objects, use other tools.

   1. In the management console, navigate to Object Storage and then to the bucket you want to upload the image to.
   2. In the left-hand panel, click Objects and then Upload in the top-right corner.
   3. In the window that opens, select the image file and click Open.
   4. In the object upload window, click Upload and wait for the image to upload.
   5. Refresh the page.

   1. Run this command:

      yc storage s3api put-object \
        --body <local_file_path> \
        --bucket <bucket_name> \
        --key <object_path>
      

      Where:

      • --body: Path to the file you need to upload to the bucket, e.g., ./ubuntu.iso.
      • --bucket: Name of your bucket.
      • --key: Key by which to store the object in the bucket, e.g., Ubuntu-2404.iso.

      Result:

      etag: '"87740887a5159e2685500c02********"'
      request_id: 300dceee********
      

   For more information about the yc storage s3api put-object command, see the Yandex Cloud CLI reference.

3. Get a link to the image uploaded to the bucket:

   Management console

   1. In the management console, select a folder.
   2. Go to Object Storage and select the bucket.
   3. Click the name of the object with the uploaded ISO image.
   4. In the top-right corner, click Get link.
   5. Click Get link.
   6. Copy the link.

Creating an image in BareMetalCreating an image in BareMetal

Create a new image using the link you got in Object Storage:

Deleting the image from Object StorageDeleting the image from Object Storage

Once your image is successfully created, you can delete the source image file from Object Storage. You can also delete the bucket if it contains no objects.