> ## Documentation Index
> Fetch the complete documentation index at: https://yoursshlabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# RDP remote desktop

> Connect to Windows, xrdp and other RDP servers from a YourSSH tab, with certificate pinning, an optional SSH tunnel and a fullscreen mode.

YourSSH has a built-in RDP client. An RDP session opens as a tab next to your SSH sessions, so you don't need a separate remote desktop app.

## Add an RDP host

**1. Open the host editor**

On the hosts dashboard, click **New host**, or open an existing host and click **Edit**.

**2. Switch to RDP**

At the top of the editor, select **RDP** in the **SSH / RDP / VNC** switch. The port changes to `3389`. A custom port you already typed is kept.

**3. Fill in the connection**

Enter the hostname or IP, **Username** and **Password**. **Domain** is optional and only needed for Windows domain accounts.

**4. Choose the RDP options**

Set **RDP SECURITY**, **CLIPBOARD** and **SSH TUNNEL** as described below, then click **Save**.

![Host editor in RDP mode with the SSH, RDP and VNC switch, hostname, port 3389, username, password, domain and RDP security fields](https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/12-rdp/01-editor-rdp-mode.png?fit=max\&auto=format\&n=vNM8XA5Zlrh1XSOb\&q=85\&s=5d7abf544ec1db78c4f5f1759aaafb6e)

The host editor in RDP mode: port 3389, credentials, domain and RDP security.

### RDP security

| Option | Meaning |
| - | - |
| **Auto (negotiate)** | Let the client and server agree. Use this unless you have a reason not to. |
| **NLA (CredSSP)** | Network Level Authentication. |
| **TLS only** | Skip NLA and use TLS only. |

### Clipboard

**Accept remote clipboard** controls whether the remote desktop may replace your local clipboard. It is on by default. The remote text is capped at 1 MiB. Turn it off for hosts you don't trust.

### SSH tunnel

**SSH TUNNEL** routes the RDP connection through one of your saved SSH hosts. Choose **Direct connection** (the default) or **via** a host. The selector only appears when you have at least one other SSH host saved. The list only shows SSH hosts. See [Hosts](https://yoursshlabs.com/user-guide/hosts.md) for connection chains.

![Lower part of the RDP host editor showing RDP SECURITY set to Auto, the Accept remote clipboard switch and the SSH TUNNEL selector](https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/12-rdp/02-rdp-security.png?fit=max\&auto=format\&n=vNM8XA5Zlrh1XSOb\&q=85\&s=a6bc27212ae4ea29f7e7a8c94174215e)

RDP-only options: RDP security, remote clipboard and the SSH tunnel.

RDP hosts carry an **RDP** badge on the hosts dashboard, in list rows and in the host panel header.

![Hosts dashboard with the Demo Desktop card marked with an RDP badge](https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/12-rdp/04-dashboard-rdp-badge.png?fit=max\&auto=format\&n=vNM8XA5Zlrh1XSOb\&q=85\&s=d576c95c60ed117ea6dca218eff39128)

The RDP host card shows an RDP badge.

## Connect and trust the certificate

Click the host card to connect. The first time you connect to a server, YourSSH stops before it sends any credentials and shows **Trust RDP certificate?** with the server address and the certificate's SHA-256 fingerprint.

![Trust RDP certificate dialog with the server address, SHA-256 fingerprint and Reject and Accept buttons](https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/12-rdp/05-cert-trust-dialog.png?fit=max\&auto=format\&n=vNM8XA5Zlrh1XSOb\&q=85\&s=080153be3260230492fc9f981cb89e59)

The first connect asks you to verify the server certificate.

* Click **Accept** to pin the certificate and continue. YourSSH reconnects and signs in.
* Click **Reject** to cancel. Nothing was sent to the server.

Compare the fingerprint with one you trust before you accept.

> [!WARNING]
>
> If the server's certificate changes later, YourSSH aborts the connection before authentication and shows **RDP certificate changed**. Your password is never sent. Click **Trust new cert** only if you know the certificate was replaced. Otherwise click **Reject**, because a changed certificate can mean someone is intercepting the connection.

## Use the session

![RDP session showing a remote Linux desktop, the toolbar with four icon buttons and the Connected status bar](https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/12-rdp/06-session-connected.png?fit=max\&auto=format\&n=vNM8XA5Zlrh1XSOb\&q=85\&s=a3da199589edd6e6c9832a9475fee0da)

A connected RDP session with the toolbar on the right.

The toolbar at the top right has four buttons:

| Button | What it does |
| - | - |
| **Send Ctrl+Alt+Del** | Sends the key combination to the remote desktop. |
| **Push clipboard to remote** | Sends your local clipboard text to the remote desktop. |
| **Fullscreen** | Hides the app chrome. Available while connected. |
| **Disconnect** | Ends the session. |

* **Keyboard and mouse.** Keys, left, right and middle clicks and scrolling go to the remote desktop. App shortcuts are not typed into it.
* **Clipboard.** Text copied on the remote desktop lands in your local clipboard, if **Accept remote clipboard** is on. YourSSH also sends your local clipboard when the RDP view gains focus, but only if the text changed since the last push.
* **Size.** The desktop size follows your window when you connect. The status bar shows the negotiated size.

Rename, color tag and pin work on RDP tabs like on SSH tabs. See [Terminal](https://yoursshlabs.com/user-guide/terminal.md).

## Fullscreen

Click **Fullscreen** in the toolbar. The tab bar and sidebar disappear and the remote desktop fills the screen.

A small pill with the host name and the toolbar buttons shows for a moment and then hides. Move the mouse to the top edge of the screen to bring it back. Use its exit button to leave fullscreen.

![Fullscreen remote desktop with a floating pill at the top showing the host name and four icon buttons](https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/12-rdp/10-fullscreen-hover-pill.png?fit=max\&auto=format\&n=vNM8XA5Zlrh1XSOb\&q=85\&s=d396f04468c68881c4efe19357077d36)

Hover the top edge in fullscreen to show the pill. It carries Ctrl+Alt+Del, clipboard, exit fullscreen and disconnect.

YourSSH leaves fullscreen on its own if the session disconnects or you switch to another tab.

## Disconnects and Retry

When the session ends, the tab shows the reason and a **Retry** button. This happens when you click **Disconnect**, when the server ends the session, or when the connection drops. Click **Retry** to connect again.

![Ended RDP session with the text disconnected by user and a Retry button](https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/12-rdp/12-disconnected.png?fit=max\&auto=format\&n=vNM8XA5Zlrh1XSOb\&q=85\&s=36a1603512ead17b6c9f93eb522f8fe1)

After you disconnect, the tab keeps the reason and offers Retry.

Unexpected drops also appear in the notification bell. Connects and disconnects are written to the [audit log](https://yoursshlabs.com/user-guide/audit-log.md).

## Not supported

* Audio redirection.
* Drive and printer redirection.
* Changing the desktop size while connected. Reconnect to apply a new window size.
* Recording, split view, the input bar and snippets. These are SSH-only and hidden on RDP tabs.

## Related pages

> [card] [VNC remote desktop](https://yoursshlabs.com/user-guide/vnc.md)
>
> Connect to Linux VNC servers.

> [card] [Hosts](https://yoursshlabs.com/user-guide/hosts.md)
>
> Add, group and tag hosts.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.