Using a remote desktop is a very convenient way to access your Raspberry Pi interface from another computer. This way, you can follow my tutorials on this website (for example) and apply them directly from the same device. There are several ways to do this. In this article, I will introduce you to the 5 best methods.
The easiest solution to remote access a Raspberry Pi with the full desktop experience is to use VNC, which is included by default on Raspberry Pi OS and works from any computer or smartphone. Other good alternatives include NoMachine, Teamviewer or RDP.
If you’re looking to quickly progress on Raspberry Pi, you can check out my e-book here. It’s a 30-day challenge where you learn one new thing every day until you become a Raspberry Pi expert. The first third of the book teaches you the basics, but the following chapters include projects you can try on your own.
1. Install XRDP on Raspberry Pi OS
Warning: This method currently doesn’t work on a fresh installation of Raspberry Pi OS Bullseye. You won’t be able to log in. A workaround is to disable the auto-login in the Raspberry Pi Configuration tool or use another account (create a new user).
XRDP is an open-source remote desktop protocol server, which allows you to connect to the Linux desktop from any operating system.
If you need to open or redirect access on your router or firewall, know that XRDP uses the standard port 3389.
The installation of XRDP is straightforward as it’s available in the original Raspberry Pi OS repositories.
All you have to do is run the following command:
sudo apt-get install xrdp
XRDP is now installed as on your Raspberry Pi, so you can manage it with the usual command:
sudo service xrdp start | stop | restart | status
If you are not familiar with the command line on Linux, you might consider checking this other article first. I explain the most useful commands on Raspberry Pi, you can even download a cheat sheet with all of them.
But you can also use the Add/Remove software tool to install it if you prefer not to use the command line.
To connect from a PC under Linux, I recommend using a solution like Remmina.
It is included in the repositories for most distributions, so you can install it with:
sudo apt install remmina
"You requested an h264 GFX mode for server 192.168.1.15, but your libfreerdp does not support h264. Please check color depth settings."
So, I had to add it as a shortcut, as the quick connection does not allow defining the color depth.
By choosing GFX RFX in the list, the error disappeared, and I was able to connect.
Here is a screenshot of my configuration if you experience the same issue:
The good thing with XRDP is that Windows users already have the client to connect to it. It’s the same protocol that Windows uses to allow users to access Windows servers remotely, so we can use the same tool.
From Windows start the “Remote Desktop Connection” tool from the start menu and fill the IP address:
If you don’t know the IP address, you can read this article that will explain several ways to find the IP address.
You can also type “raspberrypi” if there is only one on your network, that’s the default computer name.
Click on “Connect” and you will get the XRDP login screen:
All you need to do is enter the credentials (pi / raspberry by default) and click OK.
Set Xorg for Session if you do not know what you are doing.
The desktop will then be displayed relatively well.
In my case, the icons were a bit big, so I changed it in the appearance options, but otherwise it was usable immediately.
From Mac OS
I could not do the test on Mac OS, but there are several RDP clients that you can use the same way.
For example, download “Microsoft Remote Desktop” from the App Store, and connect to your Raspberry Pi by specifying its IP address (follow the same procedure as for Windows users once the app installed).
From a smartphone
You can also use the RDP protocol from a smartphone quite easily.
The application “Microsoft Remote Desktop” is also available for Android and iOS.
So, it’s possible to connect and use it, but don’t expect a great experience, as the smartphone screen is not ideal to control a computer!
If you want to learn more about XRDP on Raspberry Pi, click on the link to read my dedicated tutorial about it.
2. Enable SSH and use X11 Forwarding
X11 is the main Linux graphical window manager.
X11 forwarding over SSH is one way to start an app from a server when connected to it via SSH.
In our case, this will launch Raspberry Pi applications from our desktop (so it is not full access to the desktop).
This method could work from a remote location. It would be enough to open SSH port (22) from outside.
Remember to limit the allowed IP addresses in this case, and maybe set up additional protections like Fail2ban to avoid any security issues.
X11 forwarding is enabled by default on Raspberry Pi OS, but you need to enable SSH, that is now disabled on any fresh installation.
The easy way to do this is to open the Raspberry Pi Configuration tool, go to the “Interfaces” tab and enable SSH:
If you have any problems you can check that X11Forwarding is uncommented and set to yes in /etc/ssh/sshd_config.
I wrote an entire guide about SSH on Raspberry Pi, you should probably read it first if this is new for you.
From Linux or Mac OS
Using Linux or macOS, the access is almost the same because you only have to log in to SSH by adding a parameter:
ssh -X email@example.com
Obviously, you’ll need to use your Raspberry Pi IP address instead of mine.
Enter your password, and then start your app with the nohup command:
nohup chromium-browser &
Replace chromium-browser with the app of your choice.
The application will open on your computer (with more or less slow depending on the case.
If you are on Windows, it’s less simple but still not that complicated.
You will need these applications:
– Putty (which you probably already have for the SSH connection)
– Xming (download it on Sourceforge)
Once Xming is installed (the default options work very well), follow these steps:
Once in the console, you can launch a Raspberry application on your Windows computer with the nohup command:
nohup baobab &
This will start the Raspberry Pi disk manager on your Windows desktop:
From a smartphone
I don’t think it’s possible to use this method from your phone (tell me if you know how).
I’ve already seen people starting an X server on Android to use an android app on their computer, but not the other way around.
3. Remote Access the Raspberry Pi with VNC
VNC (Virtual Network Computing) is a system to share a graphical desktop, pretty similas to XRDP.
The difference is that you connect to the current session directly, unlike XRDP which creates a new session.
There are many VNC servers and clients you can use (RealVNC, TightVNC, UltraVNC, …).
VNC runs on port 5900.
You can NAT this port to make it available from the outside if needed, but it’s not the safest option, consider the next solution listed in this article.
Like SSH, VNC is already installed on any Raspberry Pi OS version so we just need to enable it.
To do this, open the Raspberry Pi configuration tool, go to the “Interfaces” tab and check the “Enabled” box on the VNC line.
That’s it, the VNC server is installed and ready to use.
Leave the default option (Standalone) if it is to use once, but I advise you to choose the .deb or the .rpm according to your OS, to have the RealVNC shortcut in the programs.
In most cases, you can install it by double-clicking on the file:
But if necessary you can do it on the command line, for example:
Debian like :
dpkg -i VNC-Viewer-6.18.625-Linux-x64.deb
Redhat like :
rpm -ihv VNC-Viewer-6.18.625-Linux-x64.rpm
Then the use of RealVNC is super simple, just indicate the IP of Raspberry Pi and validate.
Access will be automatically bookmarked for future times.
From Windows it is the same thing, you can download and install RealVNC from their official website.
Then launch the software via the start menu, type the IP of the Raspberry Pi and here you are connected to the remote desktop.
The requested logins are the usual users of the system (for example pi/raspberry if you have not changed the password)
From Mac OS
RealVNC is also available for Mac OS, so just get and install it and then follow the same steps as below.
From a smartphone
RealVNC also provides an app for iOS and Android smartphones so that you can use it every time, everywhere.
You can also use this solution with an iPad (as explained in my article here), it would be like if your iPad was the Raspberry Pi monitor.
Need a more in-depth guide on how to use VNC on your Raspberry Pi? Click on the link to read my complete article on this topic, where I answer all your questions.
4. Best for External Access: Teamviewer
Teamviewer is a proprietary software very close to VNC for remote desktop use but adds additional features, mostly business-oriented.
For example, Teamviewer facilitates remote access to a machine in another building/city over the Internet.
There is no need to open a specific port for each computer as with previous solutions.
By default, TeamViewer connects on port 5938 but can also use ports 80 and 443 if not opened (so it will work natively most of the time).
I’ll give you a brief introduction about Teamviewer here, but if you want to know more, please check my complete guide about Teamviewer by clicking here.
The installation is not obvious because even if it is mentioned in the documentation of a package for the ARM, it is not present in the Linux download links and there isn’t a Raspberry Pi category.
The download is done from this page. You should be able to open this page from your Raspberry Pi, download the correct version (32 or 64 bits) and then install it with the graphical tool.
But if needed, I’ll give you the installation procedure from a terminal, without having to go to their site:
- Get the ARM package for TeamViewer:
- Install it:
sudo dpkg -i teamviewer-host_armhf.deb
- You will get some dependencies errors, fix them by doing:
sudo apt-get update
sudo apt-get -f install
- If you have a TeamViewer account (paid version), you can configure it by doing:
sudo teamviewer setup
- Otherwise, you will need to set a password to connect, like this:
sudo teamviewer passwd YOURPASSWORD
- And then you can just get the Raspberry Pi ID in this way:
sudo teamviewer info
On Linux, start by downloading the TeamViewer client from the official website.
Then install it with your package manager or by doing something like:
sudo dpkg -i teamviewer_15.25.5_amd64.deb
Start the app via the Start menu or by typing “TeamViewer” in a terminal.
Log in if you have an account.
Then enter the TeamViewer ID from the Raspberry Pi in the Partner ID field and press enter.
It will ask you the password defined previously and connect to the Raspberry Pi in remote desktop.
From Windows and macOS
For Windows and macOS users, it’s the same procedure, so I will not repeat it.
Download Teamviewer, install it and then enter ID & Password previously set.
From a smartphone
TeamViewer provides support for its software to Android, iPhone, Windows and Blackberry smartphones.
It is, therefore, possible to use the app in the same way to make spontaneous support from anywhere.
5. Remote desktop with NoMachine
NoMachine is another remote desktop access tool that you can use with your RaspberryPi.
NoMachine is based on the NX protocol, which was created to improve the performance of the classic X display. Using it is very close to the experience you have with VNC.
If used behind a firewall, please note that NoMachine uses port 4000 for connections from the client.
It is possible to change the default ports in the administration tools of the NoMachine server.
NoMachine is provided for Raspberry Pi so that you can get the package corresponding to your environment on this page.
Currently, ARMv8 is only for 64 bits systems, so if you don’t have a 64-bits OS, download the ARMv7 version, even on a Pi 4/400.
Download it with your web browser and double-click on the downloaded file to install it.
Or you can do everything in a terminal with:
sudo dpkg -i nomachine_7.7.4_1_armhf.deb
Replace the version number with the one you get.
Be patient as the installation may take a few minutes depending on your Raspberry Pi model.
Once complete, the NoMachine icon will appears in the upper-right corner.
From any OS
Once the installation is complete on the Raspberry Pi, you have to install it on the client computer as well.
Go back to the official site and download, this time, the version corresponding to your computer.
Install the downloaded file and launch NoMachine.
An assistant will start, then NoMachine will automatically detect your Raspberry Pi on the network.
You have to double click on the Raspberry Pi to connect.
It will ask you for your credentials (pi/raspberry or the password you have defined), and you will be logged in.
From a smartphone
NoMachine is also available for Android and iOS so that you can connect to your Raspberry Pi from anywhere.
I also made a video on how to use this solution with an iPad, you can watch it there.
Subscribe to the RaspberryTips YouTube channel to receive new videos in your feed :
Can I use Microsoft Remote Desktop to a Raspberry Pi from a Mac?
Several apps are available in the app store on macOS, including one from Microsoft, named “Microsoft Remote Desktop”. It can be used to access the Raspberry Pi graphic interface remotely from a Mac.
Here is the direct link to this app. Other options are available, but it’s probably the best one.
What’s the best way to remote desktop a Raspberry Pi from anywhere?
If you need to get access to the Raspberry Pi from outside the local network, it’s recommended to use Teamviewer. It uses a protocol that is safe and easy to set up (no port forwarding or firewall rules needed). It’s free for a personal usage.
The other options listed in this article can be set up to work remotely, but it’s more complicated and less secure overall.
What’s the safest way to remote access a Raspberry Pi?
SSH is the safest way to remote access a Raspberry Pi on a local network, if properly configured. If access to the desktop interface is required, XRDP and Teamviewer are also safe protocols that can be used.
Can I use Microsoft remote desktop from a Raspberry?
Remmina is available in the default repository for most distributions (including Raspberry Pi OS). It’s a tool allowing the connection via RDP from the Raspberry Pi to any RDP server (another Raspberry Pi, Linux or Microsoft server).
If you are looking for exclusive tutorials, I post a new course each month, available for premium members only. Join the community to get access to all of them right now!
So we learned to connect to the remote desktop in 5 ways:
- With the Xrdp package that provides a Windows-like remote desktop.
- With SSH and X11 Forwarding that allows launching an app on the client computer (and not the entire desktop).
- With VNC that enables local access to the Raspberry Pi.
- With Teamviewer which allows among others remote access to the Raspberry Pi.
- With NoMachine that allows local access more elegantly and quickly than VNC.
So, what is your favorite?
In my opinion, VNC and NoMachine are my favorites, with a quick and clean display, without the heaviness of Teamviewer.
But it’s because I need it only on my local network, it depends on the cases.
Another option to consider might be AnyDesk, I wrote a tutorial recently about it, you can click on the link to learn more about this tool.
Not sure where to start?
Understand everything about the Raspberry Pi, stop searching for help all the time, and finally enjoy completing your projects.
Watch the Raspberry Pi Bootcamp course now.
Master your Raspberry Pi in 30 days
Don’t want the basic stuff only? If you are looking for the best tips to become an expert on Raspberry Pi, this book is for you. Learn useful Linux skills and practice multiple projects with step-by-step guides.
Download the e-book.
If you just want to hang out with me and other Raspberry Pi fans, you can also join the community. I share exclusive tutorials and behind-the-scenes content there. Premium members can also visit the website without ads.
More details here.
Need help building something with Python?
Create, understand, and improve any Python script for your Raspberry Pi.
Learn the essentials step-by-step without losing time understanding useless concepts.
Get the e-book now.
You can also find all my recommendations for tools and hardware on this page.