Updating a Container Optimized Image VM

Written by

Yandex Cloud

Updated at August 6, 2026

View in Markdown

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

Management console

CLI

In the management console, select the folder containing the VM.
Navigate to Compute Cloud.
Click the row with the VM you want to update.
In the top panel, click Edit VM
Modify the Docker container settings section as required.
Click Save changes.

See the description of the CLI command for updating a VM:
```
yc compute instance update-container --help
```

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 |
+----------------------+-------+-------------------+---------+----------------------------------+-------------+

Update the VM.

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

Creation method	Update using `--container-image`	Update 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 for running 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 the Docker container starts.
- --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
...

Updating a Container Optimized Image VM

Was the article helpful?