Step-by-step instructions for setting up Raspberry Pi Connect.
These procedures apply to Raspberry Pi 5, 4 or 3 with Raspberry Pi OS (64-Bit), (32-Bit), (Legacy 64-Bit) or (Legacy 32-Bit).
General Notes
1. General:
The procedures below are optimized for setting up Raspberry Pi Connect on a Raspberry Pi 5, 4 or 3 with Raspberry Pi OS (64-Bit), (32-Bit), (Legacy 64-Bit) or (Legacy 32-Bit) runnig bookworm (debian 12), trixie (debian 13) and above.
2. Raspberry Pi Connect:
Raspberry Pi Connect runs on Raspberry Pi OS bookworm (debian 12), trixie (debian 13) and above, older versions of Raspberry Pi OS are not supported.
Raspberry Pi Connect is installed by default in newer Raspberry Pi OS bookworm (debian 12) installations, all trixie (debian 13) and above installations, but is disabled by default.
Raspberry Pi Connect can be enabled and setup during SD card setup as an option in Raspberry Pi Imager 2.0 (released in November 2025) and above.
3. Internet access during setup:
Many of the steps below assume and require the Raspberry Pi is connected to a network with access to the Internet.
Notice about updates, upgrades and installations failing due to repository or network congestion or outages
Occasionally updates, upgrades and installations fail due to repository or network congestion or outages.
Sometimes there is an appropriate message saying as such, sometimes a missing file is reported, and sometimes there is just a failure message without an explanation.
When this occurs, simply run the command again.
If that does not solve the issues immediately, try again later.
Check for a newer Raspberry Pi 4 or Pi 5 EEPROM image version and if found download and apply it
sudo rpi-eeprom-update -a
Select the latest Bootloader Version
sudo raspi-config
Advance Options | Bootloader Version | Latest | Yes | Finish | Would you like to reboot now? | Yes
Install or update and setup Raspberry Pi Connect
Notes:
Raspberry Pi Connect runs on Raspberry Pi OS bookworm (debian 12), trixie (debian 13) and above, older versions of Raspberry Pi OS are not supported.
Raspberry Pi Connect is installed by default in newer Raspberry Pi OS bookworm (debian 12) installations, all trixie (debian 13) and above installations, but is disabled by default.
However, it could have been enabled and setup during SD card setup as an option in Raspberry Pi Imager 2.0 (released in November 2025) and above.
If it was enabled and setup in Raspberry Pi Imager, it sould not require being enabled and setup here.
There is no danger in enabeling and seting it up again here.
Raspberry Pi Connect Screen sharing requires Wayland (Remote Graphics Support, A.K.A. compositor), the default for Raspberry Pi OS bookworm (debian 12), trixie (debian 13) and above, therefore does not work with X11.
Raspberry Pi Connect Remote shell does not use the compositor and will work with either Wayland or X11.