Running Pi OS Bookworm?
Please see our guide: Raspberry Pi 5, Bookworm and RealVNC Connect
RealVNC Server is included with Raspberry Pi OS (formerly Raspbian). It’s completely free for non-commercial use; it just needs to be enabled.
You’ll also need a VNC Viewer application for the Windows, Mac or Linux computer, or iOS or Android mobile device you want to control your Pi from.
Setting up your Raspberry Pi
RealVNC Server is included with Raspberry Pi OS (formerly Raspbian) but you still have to enable it.
First, run the following commands to make sure you have the latest version:
sudo apt-get update
sudo apt-get install realvnc-vnc-server
If you’re already using an older version of RealVNC Server, restart it:
sudo systemctl restart vncserver-x11-serviced
If not, and you’re already booted into the graphical desktop, select Menu > Preferences > Raspberry Pi Configuration > Interfaces and make sure VNC is set to Enabled.
Alternatively, run the command
sudo raspi-config, navigate to Interface Options > VNC and select Yes.
From now on, RealVNC Server will start automatically every time you boot your Raspberry Pi.
By default, RealVNC Server remotes the graphical desktop running on your Raspberry Pi. However, if your Pi is headless (not plugged into a monitor) or not running a graphical desktop, RealVNC Server can still give you graphical remote access using a virtual desktop.
You can also install RealVNC Viewer on your Raspberry Pi, in case you want to control a remote computer (or another Raspberry Pi!). To do this, use the Recommended Software program, or run the command:
sudo apt-get install realvnc-vnc-viewer
Getting connected to your Raspberry Pi
There are two ways to connect; cloud and direct. You can use either or both to access your Raspberry Pi.
To get connected, please make sure you’ve downloaded the RealVNC Viewer app to computers or devices you want to control from.
Establishing a direct connection
Direct connections are quick and simple providing you’re joined to the same private local network as your Raspberry Pi (for example, a wired or Wi-Fi network at home, school or in the office).
If you’re connecting over the Internet, it’s much safer and more convenient to establish a cloud connection.
On your Raspberry Pi, discover its private IP address by double-clicking the RealVNC Server icon on the taskbar and examining the status dialog:
On the device you will use to take control, run RealVNC Viewer and enter the IP address in the search bar:
Establishing a cloud connection
Cloud connections are convenient and encrypted end-to-end, and highly recommended for connections over the Internet. There’s no firewall or router reconfiguration, and you don’t need to know the IP address of your Raspberry Pi.
You’ll need a RealVNC account; it’s completely free to set up and only takes a few seconds. You can activate a free 14 day trial, or if using RealVNC Connect for personal, non-commercial reasons you can activate a Lite subscription. On Raspberry Pi, the Lite subscription has additional features that include both cloud and direct connectivity, system authentication, file transfer, printing and chat.
You can apply your Lite subscription to three Raspberry Pis and/or desktop computers in total. Please note you revert to the standard Lite feature set for Windows, macOS and Linux desktop computers.
Sign up for a RealVNC account by entering your email address in the box on this page, and following the instructions.
On your Raspberry Pi, select Licensing from the RealVNC Server status menu, click Next then enter your new RealVNC account's email and password and follow the on-screen instructions:
On the device you will use to take control, run RealVNC Viewer and sign in using the same RealVNC account credentials.
In RealVNC Viewer, a connection entry for your Raspberry Pi automatically appears under the name of your team. Simply tap or double-click to connect:
Authenticating to RealVNC Server
To complete a connection you must authenticate to RealVNC Server. Enter the username and password you normally use to log on to your user account on the Raspberry Pi.
By default, these credentials are
raspberry, but hopefully you’ll have changed them to something more secure by now!
Running directly rendered apps remotely
RealVNC Server can remote the screen of Raspberry Pi apps that use a directly rendered overlay, such as Minecraft, the text console, the Pi camera module, and more.
To turn this feature on, open the RealVNC Server dialog, navigate to Menu > Options > Troubleshooting, and select Enable direct capture mode. On the device you will use to take control, run RealVNC Viewer and connect (if already connected, you’ll need to reconnect).
If you’ve turned direct capture mode on and mouse movements seem erratic when using Minecraft remotely, try pressing F8 to open the RealVNC Viewer shortcut menu and selecting Relative Pointer Motion.
If performance seems impaired, try:
- On your Raspberry Pi, run
sudo raspi-config, navigate to Advanced options > Memory Split, and ensure your GPU has at least 128MB.
- Reduce your Raspberry Pi’s screen resolution.
Direct capture is not available when running RealVNC Server on Raspberry Pi OS with the KMS driver (vc4-kms-v3d) enabled. To use direct capture, enable the Fake KMS driver (vc4-fkms-v3d) instead.
Transferring files to and from your Raspberry Pi
You can transfer files to and from your Raspberry Pi providing you’re connecting from RealVNC Viewer running on a Windows, macOS or Linux desktop computer.
- To transfer files to your Raspberry Pi, click the RealVNC Viewer toolbar button and follow the instructions. Detailed steps are here.
- To transfer files from your Raspberry Pi, use RealVNC Viewer to open the RealVNC Server dialog remotely, select Menu > File transfer, and follow the instructions. Detailed steps are here.
Printing to a local printer
It can be really useful to print to a printer attached to your Windows, macOS or Linux computer if no printer is set up for your Raspberry Pi. To do this, first run the following command on your Raspberry Pi to install
cups (the Common Unix Printing System):
sudo apt-get install cups
Then, connect to your Pi using RealVNC Viewer and perform whatever the standard operation is for printing the file you want to print (for example, select a text editor’s File > Print menu option). RealVNC Server directs the output to RealVNC Viewer, and prints it to your local printer. There’s more information about remote printing here.
Creating and remoting a virtual desktop
If your Raspberry Pi is headless (that is, not plugged into a monitor) or embedded in a robot, it’s unlikely to be running a graphical desktop.
RealVNC Server can run in Virtual Mode to create a resource-efficient virtual desktop on demand, giving you graphical remote access even when there is no actual desktop to remote. This virtual desktop exists only in your Raspberry Pi’s memory:
To do this:
- On your Raspberry Pi, run the command
Make a note of the IP address/display number printed to the console, for example
- On the device you will use to take control, enter this information in RealVNC Viewer.
Stopping a virtual desktop
A virtual desktop persists until you explicitly destroy it. Run the following command when you are sure it is no longer needed:
vncserver-virtual -kill :<display-number>
Note this command will terminate any current connections without warning to those users.
Operating RealVNC Server at the command line
You can operate RealVNC Server exclusively at the command line or via SSH if you prefer.
Common commands for Raspberry Pi OS (formerly Raspbian) are:
- To start RealVNC Server now:
sudo systemctl start vncserver-x11-serviced
- To start RealVNC Server at next boot, and every subsequent boot:
sudo systemctl enable vncserver-x11-serviced
- To stop RealVNC Server:
sudo systemctl stop vncserver-x11-serviced
- To prevent RealVNC Server starting at boot:
sudo systemctl disable vncserver-x11-serviced
Troubleshooting RealVNC Server
Changing the Raspberry Pi’s screen resolution
You may want to do this if:
- Performance is impaired. A smaller screen resolution gives a more responsive experience.
- Your Raspberry Pi is headless (that is, not plugged into a monitor) and the default initial screen resolution is too small.
To change the resolution, run the command
sudo raspi-config, navigate to Display Options > VNC Resolution, and choose an option.
If this menu is not available, or you want more control, specify settings in the
||Tells your Pi an HDMI display is attached.|
||Ignores EDID/display data.|
||Defines the HDMI output group.|
||Forces (for example) 1024x768 at 60Hz.|
||Uses the Fake KMS (FKMS) driver|
See the Raspberry Pi documentation for more
hdmi_mode options, and information on
/boot/config.txt in general. You will need to reboot your Raspberry Pi for any changes to take effect.
Note that settings you specify in this file override monitors you subsequently plug in (unless you revert
hdmi_force_hotplug), so pick a resolution compatible with your regular monitor.
Specifying a screen resolution for a virtual desktop
If you run RealVNC Server in Virtual Mode to create a virtual desktop, you can specify the screen resolution (geometry) at start up, for example:
You can even specify multiple screen resolutions and cycle between them.
Optimizing for Raspberry Pi Zero and Pi 1
If performance is impaired for direct connections to a Raspberry Pi Zero or Pi 1, try turning off encryption if you are sure your private local network is secure. This reduces CPU usage.
You cannot turn off encryption for cloud connections.
- On your Raspberry Pi, open the RealVNC Server dialog and select Menu > Options > Expert.
- Change the
- Restart any existing connections.
If performance is still impaired, try reducing your Raspberry Pi’s screen resolution.