Yandex Cloud
Documentation
PresentationContact UsTry it for free
© 2026 Direct Cursus Technology L.L.C.
Yandex Container Solution
  • Comparison with other Yandex Cloud services
  • Getting started
    • All tutorials
    • Creating a VM from a Container Optimized Image
    • Creating a VM from a Container Optimized Image with an additional volume for a Docker container
    • Creating a VM from a Container Optimized Image with multiple Docker containers
    • Creating an instance group from a Container Optimized Image
    • Creating an instance group from a Container Optimized Image with multiple Docker containers
    • Updating a Container Optimized Image VM
    • Configuring data output from a Docker container to a serial port
    • Running a containerized app in Yandex Serverless Containers
    • Creating a VM and an instance group with a Container Optimized Image using Terraform
    • Transferring logs from Container Optimized Image to Cloud Logging
  • Pricing policy
  • Container Optimized Image releases
  • FAQ
  • Troubleshooting
  1. Tutorials
  2. Updating a Container Optimized Image VM

Updating a Container Optimized Image VM

Written by
Yandex Cloud
Updated at September 21, 2026
View in Markdown

Change the Docker container settings on the VM created from a Container Optimized Image.

Management console
CLI
  1. In the management console, select the folder containing the VM.
  2. Navigate to Compute Cloud.
  3. Click the row with the VM you want to update.
  4. Click Edit.
  5. Modify the Docker container settings section as required.
  6. Click Save changes.
  1. See the description of the CLI command for updating a VM:

    yc compute instance update-container --help
    
  2. Get the unique VM ID. To do this, click the row with the VM name under Compute Cloud in the management console or use this CLI command:

    yc compute instance list
    

    Result:

    +----------------------+-------+-------------------+---------+----------------------------------+-------------+
    |          ID          | NAME  |      ZONE ID      | STATUS  |           EXTERNAL IP            | INTERNAL IP |
    +----------------------+-------+-------------------+---------+----------------------------------+-------------+
    | epdbf646ge5q******** | my-vm | ru-central1-b     | RUNNING | 84.201.155.117                   | 172.18.0.21 |
    +----------------------+-------+-------------------+---------+----------------------------------+-------------+
    
  3. Update the VM.

    The way you update the VM depends on how you create it:

    Creation method Update using
    --container-image
    Update the VM using
    --docker-compose-file
    Using the --container-* parameters The system deletes the old Docker container and creates a new one. The system deletes the old Docker container and creates new containers as defined in the docker-compose.yaml file.
    Using the docker-compose.yaml file specification The system deletes the old Docker containers defined in docker-compose.yaml and creates a new container described using the --container-* parameters. The system only creates either new Docker containers, i.e., those added to docker-compose.yaml, or modified Docker containers. The system deletes the Docker containers missing from the new docker-compose.yaml file.
    • Update the VM by setting new parameters:

      yc compute instance update-container epdbf646ge5q******** \
        --container-name=my_vm_new_version \
        --container-image=cr.yandex/mirror/ubuntu:18.04 \
        --container-env=KEY1=VAL1,KEY2=VAL2 \
        --remove-container-env=KEY3 \
        --container-stdin=false \
        --container-restart-policy=Never
      

      Where:

      • --container-name: Docker container name.
      • --container-image: Name of the Docker image used to run the Docker container.
      • --container-env: Environment variables available in the Docker container.
      • --remove-container-env: Remove the environment variables whose keys are specified in the parameter.
      • --container-command: Command to run when you start the Docker container.
      • --container-stdin: Allocate a standard input buffer for a running Docker container.
      • --container-restart-policy: Parameters for the command specified in --container-command.
      • --container-privileged: Run the Docker container in privileged mode.

      Result:

      done (2s)
      id: epdbf646ge5q********
      folder_id: b1g88tflru0e********
      created_at: "2023-03-13T09:44:03Z"
      name: my-vm
      ...
      
    • Update the VM by providing a specification for multiple Docker containers:

      yc compute instance update-container epdbf646ge5q******** --docker-compose-file=<file_path>
      

      Where --docker-compose-file is the path to the Docker container spec file.

      Result:

      done (2s)
      id: fhma9omhj2e7********
      folder_id: b1g88tflru0e********
      created_at: "2023-03-13T17:08:48Z"
      name: coi-vm
      ...
      

Was the article helpful?

Previous
Creating an instance group from a Container Optimized Image with multiple Docker containers
Next
Configuring data output from a Docker container to a serial port
© 2026 Direct Cursus Technology L.L.C.