Connecting to a desktop
To connect to a desktop, use the Remote Desktop Protocol
Get connection credentials
- In the management console
, select the folder with your desktop. - In the list of services, select Cloud Desktop.
- In the left-hand panel, select
Desktops. - Select the desktop you want to connect to.
- Under Desktop user, next to the user account, click
and select Reset password. - Confirm the password reset.
- Save the new password from the pop-up window that appears and close the window.
- At the top right, click
Download RDP file.
-
Open the User desktop showcase
. -
Sign in with your Yandex ID
or using Single Sign-On (SSO). -
If the desktop you want to connect to has the
Stopped
status, run it by clicking and then confirming the action.Wait for the desktop status to change to
Active
. -
Click
and confirm the password reset. -
Save the new password from the pop-up window that appears and close the window.
-
Click
Download RDP file.
If you do not have the Yandex Cloud CLI yet, install and initialize it.
The folder specified when creating the CLI profile is used by default. To change the default folder, use the yc config set folder-id <folder_ID>
command. You can also specify a different folder for any command using the --folder-name
or --folder-id
parameter.
-
See the description of the CLI command for getting RDP file data:
yc desktops desktop get-rdp-file --help
-
Get a list of desktops in the default folder:
yc desktops desktop list
Result:
+----------------------+------------------+--------+----------------------+---------------------+ | ID | NAME | STATUS | DESKTOP GROUP ID | CREATED (UTC-0) | +----------------------+------------------+--------+----------------------+---------------------+ | e3vmvhgbgac4******** | my-cloud-desktop | ACTIVE | e3v1rbln45tl******** | 2024-10-09 22:42:28 | | e3vio1bc5ppz******** | reserved-desktop | ACTIVE | e3v1rbln45tl******** | 2024-10-09 21:35:17 | +----------------------+------------------+--------+----------------------+---------------------+
-
Select the
ID
orNAME
of the desktop you need, e.g.,my-cloud-desktop
. -
Reset the desktop user password.
-
Request the data:
yc desktops desktop get-rdp-file --name <desktop_name>
Result:
full address:s:my-cloud-desktop gatewayhostname:s:rdg.vdi.cloud.yandex.net:3839 gatewaycredentialssource:i:5 gatewayusagemethod:i:1 gatewayprofileusagemethod:i:1 gatewayaccesstoken:s:ver=1;desktopUserToken=0174a9f2-...V6DQ networkautodetect:i:0 bandwidthautodetect:i:1 connection type:i:6 username:s:.\alice-little domain:s: bitmapcachesize:i:32000 smart sizing:i:1 audiocapturemode:i:1 audiomode:i:0 authentication level:i:0
-
Save the received data to an
.rdp
file.
Use the getRdpFile REST API method for the Desktop resource or the DesktopService/GetRdpFile gRPC API call.
To reset the password, use the resetPassword REST API method for the Desktop resource or the DesktopService/ResetPassword gRPC API call.
Connect to the desktop
- Right-click the downloaded RDP file and select Edit (in Windows 11, select Show more options → Edit).
- In the Remote Desktop Connection window, open the General tab, select Allow me to save credentials, and click Connect.
- In the security window that opens, select Don't ask me again for connections to this computer and click Yes.
- Enter the password you saved previously, select Remember me, and click OK.
To reconnect to the desktop, run the RDP file you saved.
- Install and run Microsoft Remote Desktop
, the official free RDP client for macOS. - Open the Connections menu amd click Import from RDP file.
- In the window that opens, select the downloaded RDP file and click Import.
- In the Microsoft Remote Desktop menu, select Settings.
- In the window that opens, navigate to the User Accounts tab.
- Select the account you want to connect to from the list on the left, and paste the previously saved password into the Password field.
- Close the settings window.
- In the PCs tab, run the desktop you added.
- In the security window that opens, click Continue.
To reconnect to the desktop, run it from the PCs tab in the Microsoft Remote Desktop client. In the security window that opens, click Continue.
See also
-
Install Remmina
, a free RDP client for Linux, by running the following commands in the terminal:sudo apt-add-repository ppa:remmina-ppa-team/remmina-next sudo apt-get update sudo apt-get install remmina remmina-plugin-rdp
-
Start Remmina.
-
In the top menu, click
and select Import. Select the downloaded RDP file and click Import. -
Right-click the added desktop and select Edit.
-
In the Remote Connection Profile window, set up the connection:
- In the Username field, remove the first two characters:
.\
. - In the Password field, enter the previously saved password.
- In the Username field, remove the first two characters:
-
Click Save and Connect.
To reconnect to the desktop, run it in the Remmina client.