Creating a desktop group

Written by

Yandex Cloud

Updated at February 12, 2025

Management console

Yandex Cloud CLI

API

In the management console, select the folder to create your desktop group in.
In the list of services, select Cloud Desktop.
Click Create desktop group.
Enter a name and description of the desktop group.
Select an OS image.
Under Disks:
- Select the boot and working disk types.
- Specify the boot and working disk size.
Under Computing resources:
- Specify the number of vCPU cores.
- Choose guaranteed vCPU share.
- Specify the amount of RAM.
Under Network settings, select the cloud network and subnets to host desktops.
Click Create.

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

View the description of the CLI command to create a desktop group:
```
yc desktops group create --help
```

Select a folder:

yc resource-manager folder list

Result:

+----------------------+------------+--------+----------+
|          ID          |    NAME    | LABELS |  STATUS  |
+----------------------+------------+--------+----------+
| b1g681qpemb4******** | my-folder  |        | ACTIVE   |
| b1ggmp8es27t******** | new-folder |        | ACTIVE   |
+----------------------+------------+--------+----------+

Select an image to create a boot disk for the desktop. You can look up the image ID in the management console.

Select a cloud network and subnets:

yc vpc subnet list

Result:

+----------------------+-------------+----------------------+----------------------+---------------+------------------+
|          ID          |    NAME     |      NETWORK ID      |    ROUTE TABLE ID    |     ZONE      |      RANGE       |
+----------------------+-------------+----------------------+----------------------+---------------+------------------+
| e2lb1da2dd9v******** | my-subnet-b | enp0asmd9pr9******** |                      | ru-central1-b | [10.129.0.0/24]  |
| e9bhhpeo3vmk******** | my-subnet-a | enp0asmd9pr9******** |                      | ru-central1-a | [10.128.0.0/24]  |
| fl8rnqg0nb99******** | my-subnet-d | enp0asmd9pr9******** | enpajmdvphs7******** | ru-central1-d | [10.131.0.0/24]  |
+----------------------+-------------+----------------------+----------------------+---------------+------------------+

Where:

ID: Subnet ID.
NETWORK ID: Cloud network ID.

Create a desktop group:

yc desktops group create \
  --folder-id <folder_ID> \
  --image-id <image_ID> \
  --name <group_name> \
  --resource-spec memory=4G,cores=2,core-fraction=100 \
  --network-interface-spec \
    network-id=<network_ID>,subnet-id=<subnet_1_ID>,...,network-id=<network_ID>,subnet-id=<subnet_n_ID>

Where:

--folder-id: Folder ID.
--image-id: Disk image ID.
--name: Desktop groups name.
--resource-spec: Description of the desktop group computing resources:
- memory: Amount of RAM.
- cores: Number of vCPUs.
- core-fraction: Guaranteed vCPU share.
--network-interface-spec: Description of the desktop group network interface:
- network-id: Cloud network ID.
- subnet-id: Subnet ID.
You can specify one or more subnets from the same cloud network.

Result:

id: e3v80f10pc01********
folder_id: b1g681qpemb4********
created_at: "2024-10-09T18:58:17.357Z"
status: ACTIVE
name: my-desktop-group
resources_spec:
  memory: "4294967296"
  cores: "2"
  core_fraction: "100"
network_interface_spec:
  network_id: enp0asmd9pr9********
  subnet_ids:
    - e2lb1da2dd9v********

Use the create REST API method for the DesktopGroup resource or the DesktopGroupService/Create gRPC API call.

Creating a desktop group

Was the article helpful?