This guide shows how to set up a Remote Desktop Connection with a Raspberry Pi using RDP on Mac OS. The Remote Desktop Protocol (RDP) is the proprietary network protocol developed by Microsoft to connect to a remote desktop computer and access its graphical user interface. This allows you to connect your Mac computer to your Raspberry Pi and control its GUI remotely.
We have a similar guide for Windows PC: Raspberry Pi: Set Up Remote Desktop Connection (RDP)
Prerequisites
Before proceeding, make sure you check the following prerequisites.
- You need a Raspberry Pi board.
- Operating System: you should have a Raspberry Pi running Raspberry Pi OS (32-bit or 64-bit). The OS should have Desktop support (doesn’t work on Lite OS).
- SSH: You should be able to establish an SSH connection with your Raspberry Pi.
xrdp (open-source Remote Desktop Protocol Server)
xrdp provides a graphical login to remote machines using RDP (Microsoft’s proprietary Remote Desktop Protocol). xrdp accepts connections from a variety of RDP clients. We’ll be using Microsoft Remote Desktop Client for Mac OS (but it’s also compatible with Windows, iOS, and Android).
xrdp allows you to connect to your Raspberry Pi to control its desktop remotely.
Please note that your Raspberry Pi must be running a full Raspberry Pi OS – it will not work with a headless or Lite OS.
Installing xrdp on Raspberry Pi (Remote Desktop Protocol)
Having an SSH connection established with your Raspberry Pi, update and upgrade your Raspberry Pi, if any updates are available. Run the following command:
sudo apt update && sudo apt upgrade -y
Next, we need to install the xrdp software on your Raspberry Pi:
sudo apt install -y xrdp
That’s it. You don’t need to change any configurations, everything will work out of the box with the default settings.
Finally, run the following command to get the Raspberry Pi IP address. You’ll need the IP address to establish the remote connection.
hostname -I
Microsoft Remote Desktop Connection Software – Mac OS
The Microsoft Remote Desktop software can be installed in the App Store. Open the App Store.
Search for “Microsoft Remote Desktop” on the App Store and click the “Get” button:
After the software is installed, click “Open“.
Next press the “Add PC” button to set the Raspberry Pi settings.
Type the Raspberry Pi IP address in the computer field and press the Add button:
The Raspberry Pi PC will be added to your Microsoft Remote Desktop software, then click the “Connect” option.
Click the “Connect” button to establish the connection.
Next, type your Raspberry Pi username and password and click the “Continue” button to login into your device.
You might be prompted one more time for the authentication if you just powered your Raspberry Pi, so enter again your username and password.
That’s it! You can now control your Raspberry Pi desktop computer remotely from Mac OS.
Wrapping Up
In this tutorial, you learned a very convenient, practical, and easy way to establish a remote connection with your Raspberry Pi using xrdp. This is our favorite method to access the Raspberry Pi desktop because you don’t have to connect an additional screen, keyboard, and mouse. You can also use RDP on a Windows PC.
We hope you found this tutorial useful. You can check all our Raspberry Pi projects on the following link:
Thanks for reading.
Same here, running raspi4 with 64 bit bookworm and the rdp login process from windows 10 fails immediatly after the authentification screen. The overlay in /boot/firmware/config.txt (the /boot/config.txt exist but a notice says to use the one in 3boot/firware instead) was already uncommented. Tried the the fkms variant to no avail. I will keep you posted if i find a solution.