# Desktop via RDP

With an RDP client you open the graphical Ubuntu desktop of your workspace from Windows, macOS, or Linux.

> Source: https://www.application-platform.com/en/docs/workspace-rdp/

RDP (Remote Desktop Protocol) is the standard way to reach the graphical Ubuntu desktop of your workspace. You need a device that is signed in to the workspace network with [Tailscale]({{< relref "workspace-vm-tailscale" >}}), an RDP client, and the connection details from the **Connect** dialog on the workspace card. The dialog shows hostname, port, username, and password, and it is also where you download the prepared RDP file.

## Choosing an RDP client

On Windows, **Remote Desktop Connection** is already included. You open it from the Start menu or with `mstsc.exe`. Alternatively, there is [Microsoft Remote Desktop in the Microsoft Store](https://apps.microsoft.com/detail/9WZDNCRFJ3PS).

On macOS, the best option is [Microsoft Remote Desktop](https://apps.apple.com/app/microsoft-remote-desktop/id1295203466) from the Mac App Store, which Microsoft now calls **Windows App**.

On Linux, [Remmina](https://remmina.org/) is the recommended choice. You install it through your distribution's package manager, for example with `sudo apt install remmina`. If you prefer the command line, use FreeRDP (`xfreerdp`).

## Connecting

1. Download the **RDP file** in the **Connect** dialog and open it. It starts your RDP client with the address and username already filled in. Alternatively, open the client yourself and enter the **hostname** and **port** from the dialog.
2. Sign in with the displayed username and the copied password.
3. After signing in, the Ubuntu desktop appears. The prepared project folders are in the home directory of the workspace user.

If the Windows App on macOS stays unresponsive after the password dialog or reports error `0x207`, the causes range from name resolution through Tailscale to an outdated `.rdp` file. The checks for this are listed under [Troubleshooting]({{< relref "workspace-vm-troubleshooting" >}}).

If your workspace also offers VNC or you prefer a VNC viewer, the steps are under [Desktop via VNC]({{< relref "workspace-vnc" >}}).