> ## Documentation Index
> Fetch the complete documentation index at: https://sen-f208ff9e.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# VNC remote desktop

> Connect to Linux VNC servers from a YourSSH tab, with an optional SSH tunnel to encrypt the connection.

YourSSH has a built-in VNC client for servers such as TigerVNC, x11vnc and TightVNC. A VNC session opens as a tab next to your SSH and RDP sessions.

## Add a VNC host

**1. Open the host editor**

Click **New host** on the hosts dashboard, or **Edit** on an existing host.

**2. Switch to VNC**

Select **VNC** in the **SSH / RDP / VNC** switch at the top. The port changes to `5900`. A custom port is kept.

**3. Fill in the connection**

Enter the hostname or IP and the **Password**. The password is the VNC server password. A username is accepted, but most VNC servers ignore it.

**4. Choose clipboard and tunnel**

Set **Accept remote clipboard** and, if you want, **SSH TUNNEL**, then click **Save**.

![Host editor in VNC mode with hostname, port 5900, username, password, group, tags and the Accept remote clipboard switch](https://mintcdn.com/sen-f208ff9e/KwGOqbG40_L2ILah/images/13-vnc/01-editor-vnc-mode.png?fit=max\&auto=format\&n=KwGOqbG40_L2ILah\&q=85\&s=3095946e92c63b19af3a68189316fdb3)

The host editor in VNC mode: port 5900, password and the clipboard switch.

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

**SSH TUNNEL** routes the VNC 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. See [Hosts](https://sen-f208ff9e.mintlify.site/user-guide/hosts.md).

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

## Connect

Click the host card to connect.

> [!WARNING]
>
> Plain VNC has no encryption. There is no certificate dialog because there is no certificate, and the password exchange and the screen content travel unencrypted. Outside a trusted LAN, set an **SSH TUNNEL** so the session runs inside an encrypted SSH connection.

## Use the session

![VNC session showing a remote Linux desktop, a toolbar with three icon buttons and the Connected status bar](https://mintcdn.com/sen-f208ff9e/KwGOqbG40_L2ILah/images/13-vnc/03-session-connected.png?fit=max\&auto=format\&n=KwGOqbG40_L2ILah\&q=85\&s=fa5837ec48beb56e83990ccbbe509795)

A connected VNC session. The toolbar has push clipboard, fullscreen and disconnect.

The toolbar at the top right has three buttons:

| Button | What it does |
| - | - |
| **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, 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 VNC view gains focus, but only if the text changed since the last push.
* **Size.** The desktop uses the server's screen size and follows the server if it resizes.

## Fullscreen

Click **Fullscreen**. Move the mouse to the top edge to show a pill with **Push clipboard to remote** and **Exit fullscreen**. YourSSH leaves fullscreen on its own if the session disconnects or you switch tabs.

## Disconnects and Retry

If the server closes the connection or it drops, the tab shows a message and a **Retry** button. Unexpected drops also appear in the notification bell, and connects and disconnects are written to the [audit log](https://sen-f208ff9e.mintlify.site/user-guide/audit-log.md).

Rename, color tag and pin work on VNC tabs like on SSH tabs.

## Not supported

* TLS or VeNCrypt, macOS Screen Sharing, RealVNC and UltraVNC logins. YourSSH supports servers with no authentication or a VNC password.
* Audio and file transfer.
* Recording, split view, the input bar and snippets. These are SSH-only and hidden on VNC tabs.

## Related pages

> [card] [RDP remote desktop](https://sen-f208ff9e.mintlify.site/user-guide/rdp.md)
>
> Connect to Windows and xrdp.

> [card] [Hosts](https://sen-f208ff9e.mintlify.site/user-guide/hosts.md)
>
> Add, group and tag hosts.


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