Contact UsGet started
© 2025 Direct Cursus Technology L.L.C.

yc compute instance create-with-container

Written by
Updated at April 22, 2025

Create a virtual machine instance running Docker container

Command Usage

Syntax:

yc compute instance create-with-container <INSTANCE-NAME> [Flags...] [Global Flags...]

Flags

Flag Description
--name string
A name of the instance.
--description string
Specifies a textual description of the instance.
--labels key=value[,key=value...]
A list of label KEY=VALUE pairs to add. For example, to add two labels named 'foo' and 'bar', both with the value 'baz', use '--labels foo=baz,bar=baz'.
--zone string
The zone of the instance to create.
--metadata key=value[,key=value...]
Metadata to be made available to the guest operating system running on the instance.
See for details https://yandex.cloud/ru/docs/compute/concepts/vm-metadata
--metadata-options PROPERTY=VALUE[,PROPERTY=VALUE...]
Options set the access mode to instance's metadata.

Possible property names:
  • aws-v1-http-endpoint: Enables access to AWS flavored metadata (IMDSv1). Values: enabled, disabled
  • aws-v1-http-token: Enables access to IAM credentials with AWS flavored metadata (IMDSv1). Values: enabled, disabled
  • gce-http-endpoint: Enables access to GCE flavored metadata. Values: enabled, disabled
  • gce-http-token: Enables access to IAM credentials with GCE flavored metadata. Values: enabled, disabled
--metadata-from-file key=value[,key=value...]
Same as --metadata except that the value for the entry will be read from a local file.
--ssh-key string
Creates user 'yc-user' and adds SSH key from specified file to authorized keys using cloud-config.
If your need more flexibility, use cloud-config passed in 'user-data' metadata key.
--public-ip If true, one-to-one NAT public IP will be created for the default network interface. Cannot be passed together with --network-interface
--public-address string
If set, one-to-one NAT public IP will be created for the default network interface with the specified value. Cannot be passed together with --network-interface
--create-disk PROPERTY=VALUE[,PROPERTY=VALUE...]
Creates and attaches persistent disks to the instance.

Possible property names:
  • name: Specifies the name of the disk.
  • type: The type of the disk. To get a list of available disk types, run 'yc compute disk-type list'. The default disk type is network-hdd.
  • size: The size of the disk in GB. You can also use M and T suffixes to specify smaller or greater size respectively. If not specified, inferred size is used. If the disk is created from a snapshot, disk size of the snapshot is used. If the disk is created from an image, size of the image is used.If no source is specified, default disk size is used.
  • block-size: Specifies the block size of the disk in bytes. You can also use K and M suffixes.
  • snapshot-name: A source snapshot used to create the disk.
  • snapshot-id: An ID of the source snapshot used to create the disk.
  • image-name: A source image used to create the disk.
  • image-id: An ID of the source image used to create the disk.
  • image-family: An image family that is used to create the disk.
  • image-folder-id: The folder ID that is used to resolve references for image-name or image-family.
  • disk-placement-group-id: An ID of the placement group to create the disk in
  • disk-placement-group-name: A placement group to create the disk in
  • disk-placement-group-partition: A placement group partition to create the disk in. Used when a placement group is created with the partition strategy.
  • kms-key-name: KMS key used to encrypt the disk.
  • kms-key-id: An ID of the KMS key used to encrypt the disk.
  • device-name: Specifies a unique serial number of your choice that is reflected into the /dev/disk/by-id/ tree of a Linux operating system running within the instance.
  • auto-delete: Specifies if this persistent disk will be automatically deleted when the instance is deleted.
--attach-disk PROPERTY=VALUE[,PROPERTY=VALUE...]
Attaches persistent disks to the instances. The specified disks must already exist.

Possible property names:
  • disk-name: The disk to attach to the instance.
  • disk-id: An ID of the disk to attach to the instance.
  • device-name: Specifies a unique serial number of your choice that is reflected into the /dev/disk/by-id/ tree of a Linux operating system running within the instance.
  • auto-delete: Specifies if this persistent disk will be automatically deleted when the instance is deleted.
--create-boot-disk PROPERTY=VALUE[,PROPERTY=VALUE...]
Creates a new disk and uses it as a boot disk of the instance.

Possible property names:
  • name: Specifies the name of the disk.
  • type: The type of the disk. To get a list of available disk types, run 'yc compute disk-type list'. The default disk type is network-hdd.
  • size: The size of the disk. If not specified, inferred size is used. If the disk is created from a snapshot, disk size of the snapshot is used. If the disk is created from an image, size of the image is used.If no source is specified, default disk size is used.
  • device-name: Specifies a unique serial number of your choice that is reflected into the /dev/disk/by-id/ tree of a Linux operating system running within the instance.
  • auto-delete: Specifies if this persistent disk will be automatically deleted when the instance is deleted.
--use-boot-disk PROPERTY=VALUE[,PROPERTY=VALUE...]
Uses an already existing disk as a boot disk of the instance.

Possible property names:
  • disk-name: The disk to attach to the instance.
  • disk-id: An ID of the disk to attach to the instance.
  • device-name: Specifies a unique serial number of your choice that is reflected into the /dev/disk/by-id/ tree of a Linux operating system running within the instance.
  • auto-delete: Specifies if this persistent disk will be automatically deleted when the instance is deleted.
--attach-filesystem PROPERTY=VALUE[,PROPERTY=VALUE...]
Attaches filesystems to the instances. The specified filesystems must already exist.

Possible property names:
  • device-name: This value can be used to reference the device for mounting, resizing, and so on, from within the instance.
  • filesystem-name: The filesystem to attach to the instance.
  • filesystem-id: An ID of the filesystem to attach to the instance.
--attach-local-disk PROPERTY=VALUE[,PROPERTY=VALUE...]
Attaches local disks to the instances.

Possible property names:
  • size: The size of the local disk in bytes. You can also use M and T suffixes to specify MiB or TiB respectively.
--network-settings PROPERTY=VALUE[,PROPERTY=VALUE...]
Network settings for the instance.

Possible property names:
  • type: Type of a network for virtual machine instance. Values: standard, software-accelerated
--network-interface PROPERTY=VALUE[,PROPERTY=VALUE...]
Adds a network interface to the instance.

Possible property names:
  • subnet-name: Specifies the subnet that the interface will be part of.
  • subnet-id: Specifies the ID of the subnet that the interface will be part of.
  • address: Assigns the given internal address to the instance that is created. If no address is specified, some unassigned address from the subnet is used.
  • ipv4-address: Assigns the given internal IPv4 address to the instance that is created. If 'auto' used as value, some unassigned address from the subnet is used.
  • nat-ip-version: Specifies IP version for One-to-One NAT. Can be 'ipv4'. This flag can be applied to network interfaces with ipv4 address.
  • nat-address: Specifies public IP address for One-to-One NAT. This flag can be applied to network interfaces with ipv4 address.
  • security-group-ids: Security groups for the network interface, security-group-ids=[id1,id2],security-group-ids=id3
  • dns-record-spec: DNS records in format {name=<name>[,ttl=<ttl>][,dns-zone-id=<id>][,ptr={true|false}]}
--serial-port-settings PROPERTY=VALUE[,PROPERTY=VALUE...]
Serial port settings for the instance.

Possible property names:
  • ssh-authorization: Authorization mode in interactive serial port console via SSH. Values: instance_metadata, os_login
--memory byteSize
Specifies how much memory instance should have.
--cores int
Specifies how many CPU cores instance should have.
--core-fraction int
If provided, specifies baseline performance for a core in percent.
--gpus int
Specifies how many GPUs instance should have.
--platform string
Specifies platform for the instance.
--hostname string
Creates instance with specified hostname.
--preemptible Creates preemptible instance.
--maintenance-policy string
Behaviour on maintenance events. Values: 'restart', 'migrate'
--maintenance-grace-period duration
Time between notification via metadata service and maintenance.
--placement-group-id string
Placement group to create the instance in.
--placement-group-name string
Placement group to create the instance in.
--placement-group-partition int
Specifies placement group partition for the instance.
--host-group-id string
Host group to create the instance in.
--host-group-name string
Host group to create the instance in.
--host-id string
Host to create the instance in.
--gpu-cluster-id string
GPU cluster to create the instance in.
--gpu-cluster-name string
GPU cluster to create the instance in.
--service-account-id string
Service account, which token can be obtained inside VM from metadata service.
--service-account-name string
Service account, which token can be obtained inside VM from metadata service.
--reserved-instance-pool-id string
Reserved instance pool to create the instance in.
--reserved-instance-pool-name string
Reserved instance pool to create the instance in.
--async Display information about the operation in progress, without waiting for the operation to complete.
--container-arg value[,value]
A list of arguments to append to container entrypoint. Overrides default container CMD
--container-command string
Executable to run when the container starts. Overrides default container ENTRYPOINT
--container-env key=value[,key=value...]
Declare environment variable KEY with value VALUE passed to container. Only the last value of KEY is taken when KEY is repeated more than once.
Values, declared with --container-env flag override those with the same KEY from file, provided in --container-env-file.
--container-env-file string
Declare environment variables in a file. Values, declared with --container-env flag override those with the same KEY from file.
File must contain lines in format KEY=VALUE, variables without value are not supported.
--container-image string
Container image name.
--container-name string
Container name.
--container-privileged Specify whether to run container in privileged mode.
--container-stdin Open container STDIN.
--container-tty Allocate a pseudo-TTY for the container.
--container-restart-policy string
Specify whether to restart a container on exit. Must be one of: Always, Never, OnFailure. Default: Always.
--container-volume-tmpfs PROPERTY=VALUE[,PROPERTY=VALUE...]
Add tmpfs-backed docker volume

Possible property names:
  • name: Specifies the name of the volume. (required)
  • mount-path: Specifies the mount path of the volume inside a container. (required)
--container-volume-host-path PROPERTY=VALUE[,PROPERTY=VALUE...]
Add docker volume bound to host path

Possible property names:
  • name: Specifies the name of the volume. (required)
  • mount-path: Specifies the mount path of the volume inside a container. (required)
  • ro: Specifies whether the volume is read-only or not inside a container. Default: false
  • host-path: Specifies a path on host VM that will be bound to the volume. (required)
--docker-compose-file string
Docker compose file.
--coi-spec-file string
Container optimized image YAML file.

Global Flags

Flag Description
--profile string
Set the custom configuration file.
--debug Debug logging.
--debug-grpc Debug gRPC logging. Very verbose, used for debugging connection problems.
--no-user-output Disable printing user intended output to stderr.
--retry int
Enable gRPC retries. By default, retries are enabled with maximum 5 attempts.
Pass 0 to disable retries. Pass any negative value for infinite retries.
Even infinite retries are capped with 2 minutes timeout.
--cloud-id string
Set the ID of the cloud to use.
--folder-id string
Set the ID of the folder to use.
--folder-name string
Set the name of the folder to use (will be resolved to id).
--endpoint string
Set the Cloud API endpoint (host:port).
--token string
Set the OAuth token to use.
--impersonate-service-account-id string
Set the ID of the service account to impersonate.
--no-browser Disable opening browser for authentication.
--format string
Set the output format: text (default), yaml, json, json-rest.
--jq string
Query to select values from the response using jq syntax
-h,--help Display help for the command.
Previous
create
Next
delete