Connecting to a desktop

1. Open the User desktop showcase.

2. Authenticate with your Yandex ID or Single Sign-On (SSO).

3. If the desktop you want to connect to has the Stopped status, run it by clicking and confirm the action.

   Wait for the desktop status to change to Active.

4. Click and confirm the password reset.

5. Save a new password from the pop-up window and close it.

6. Click Download RDP file.

If you do not have the Yandex Cloud command line interface yet, install and initialize it.

The folder specified in the CLI profile is used by default. You can specify a different folder using the --folder-name or --folder-id parameter.

1. See the description of the CLI command to get RDP file data:

   yc desktops desktop get-rdp-file --help
   

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

3. Select the ID or NAME of the desktop you need, e.g., my-cloud-desktop.

4. Reset the desktop user password.

5. 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
   

6. Save the resulting data to a file with the .rdp extension.

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.

1. Install and run Microsoft Remote Desktop, an official free RDP client for macOS.
2. Open the Connections menu amd click Import from RDP file.
3. In the window that opens, select the downloaded RDP file and click Import.
4. Open the Microsoft Remote Desktop menu and select Settings.
5. In the window that opens, go to the User Accounts tab.
6. In the list of accounts on the left, select the account to connect and paste the previously saved password into the Password field.
7. Close the settings window.
8. In the PCs tab, run the desktop added.
9. In the security window, click Continue.

To reconnect to the desktop, run it in the Microsoft Remote Desktop client in the PCs tab. In the security window, click Continue.

See alsoSee also

• Getting started with Remote Desktop on macOS

1. Install Remmina, a free RDP client for Linux. Run 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
   

2. Start Remmina.

3. In the top menu, click and select Import. Run the downloaded RDP file and click Import.

4. Right-click the added desktop and select Edit.

5. In the Remote Connection Profile window, set up the connection:

   • In the Username field, remove the first two characters: .\.
   • In the Password field, type the previously saved password.

6. Click Save and Connect.

To reconnect to the desktop, run it in the Remmina client.

See alsoSee also

• Installing Remmina on Linux distributions other than Ubuntu