How to use Raspberry Pi Connect: installation, pairing, and remote access

  • Official remote access and encryption via WebRTC with Raspberry Pi ID identity.
  • Two modes: Shell (wide compatibility) and Desktop (Pi 4/5/400 with Bookworm 64‑bit).
  • Simple installation with apt and linking by icon or rpi-connect signin command.
  • Web Device Management: Rename, Delete, and 2FA Recommendations.

Raspberry Pi Connect remote access

Imagine having your Raspberry Pi just a click away, from anywhere and with just a browser, without any headaches with ports or strange configurations: that's exactly what it offers. Raspberry Pi ConnectThe idea is simple but powerful: open a terminal or desktop session on your Pi from the web using a secure peer-to-peer connection.

Before, the typical alternatives were SSH, VNC or TeamViewer, each with its own nuances and limitations (local network, complex configurations, licensing, etc.). With the official Raspberry Pi offering, this friction is reduced: You install the package, link your device to your account and enter through the browserBelow you'll find a complete guide with requirements, installation, pairing, connection methods, and key options.

How to use the Raspberry Pi Connect software to connect remotely-4
Related article:
How to set up and use Raspberry Pi Connect for remote access

What is Raspberry Pi Connect?

Raspberry Pi Connect is an official remote access client that runs on WebRTC, the same technology used in many video calling apps, to establish end-to-end encrypted links between your Raspberry Pi and your browser. When latency or direct routing is not feasible, traffic may navigate Raspberry Pi servers in the UK, maintaining encryption and your account as an identity.

The tool is in beta, is free as intended by the Foundation, and aims to replace tedious third-party setups with a simple solution: Access the desktop or a shell from connect.raspberrypi.comIn real-world testing, the remote desktop feels very fluid—some users even find it more responsive than VNC—and the remote shell is responsive.

As an official client, it integrates with Raspberry Pi OS and adds a icon on the taskbar In the case of the desktop edition, from your web account, you'll see all your associated devices and can log in with a couple of clicks, without having to remember public IP addresses or touch your router.

There are important compatibility nuances that should be clear: for the remote desktop part, the system uses the composer Wayland; In addition, various guides point out requirements that vary between shell and desktop functions, as we will see later. A previous reference mentioned the version v1.2 of the software at the time of writing, so improvements can be expected frequently.

Guide to using Raspberry Pi Connect

Requirements and compatibility

For the function of Remote Desktop (Screen Sharing), various sources indicate that it is currently intended for Raspberry Pi 5, Raspberry Pi 4 and Raspberry Pi 400, with Raspberry Pi OS Bookworm 64-bit. This limitation comes from the graphics stack and the use of Wayland, in addition to the maturity of the beta itself.

Regarding Remote Shell, there are guides that point out wide compatibility, even in older models (up to a Raspberry Pi 1) and with previous versions of the system, even mentioning that It also works on Buster and Lite editions. In practice, to get the best experience and official support, it is recommended to start from Raspberry Pi OS 12 (Bookworm) updated.

On modern equipment with the system up to date, you will frequently find rpi-connect pre-installedIf it doesn't appear, you can install it with apt, and on systems without a graphical environment, use its lightweight version. This duality of packages allows it to adapt to both desktop and headless installations.

Beyond the hardware and system, you'll need a Raspberry Pi ID accountThis is the "key" that authorizes the connection between your device and the web panel, and will allow you to view and manage all your devices with a single identity.

Software Installation: Desktop vs Lite

There are two packages: rpi-connect for desktop systems, and rpi-connect-lite For Lite installations without a graphical environment, it's best to update the system first and then install the corresponding package.

Installing on Raspberry Pi OS with desktop (when not pre-installed): update, install and restartAs a visual clue, after the restart you'll see a round icon with two dots at the top of your desktop, indicating that the service has been successfully activated.

If you work with Raspberry Pi OS Lite, the process is similar, but installing the “lite” variant, which offers access to remote shell without the graphical part. You can operate via SSH or with a connected keyboard/monitor and launch the installation without complications.

Example commands (adapting the package to your case): apt update, apt upgrade, apt install and rebootIt's a standard flow that ensures dependencies are in order and the service is registered and enabled.

As the beta progresses, there will likely be frequent updatesYou can keep only the Connect package up to date with an upgrade-only installation, minimizing changes to other system components.

Create and secure your Raspberry Pi ID

To use Connect you need a official count. Registration is quick: go to the identity website, You enter your email, define your password and verify using the link sent to you by email. After logging in for the first time, you'll be ready to pair devices.

It is highly recommended activate two-factor authentication (2FA), as this account controls remote access to your devices. With an app like Google Authenticator or Authy, you scan a code and add an extra layer of protection in seconds.

Once inside, the account panel will allow you to see your associated devicesFrom there, you can start sessions, change names, and delete devices when you're no longer using them or want to withdraw their access.

If you've never used similar services, think of the account as the "central control": without it there is no connectionThis way, even if someone were to discover your IP or hostname, they wouldn't be able to log in to your Connect if they didn't have control of your credentials.

Link your Raspberry Pi to the account

Once the package is installed on the Pi and your identity is created, tap pair the device with your account. You can do this from the graphical interface (if you have a desktop) or from the Command line.

Graphical option (desktop): search for the Raspberry Pi Connect icon in the top tray. When you tap it, choose “Sign in” and the browser will open to authenticate with your Raspberry Pi ID. The wizard will ask you to give the team a name (for example, “Pi-Server-Home”) and confirm. Once this is done, the link is established.

Terminal option (desktop or Lite): In a console, run rpi-connect signinThe system will show you a unique URL; copy it into a browser on any device, log in with your account, give the Pi a name and the process endsThe terminal will indicate that the pairing was successful.

Both routes lead to the same result: your Pi will appear on the Connect page as an available device, with its connection options visible depending on your system version and capabilities.

A small practical note: the service can start with the system and, if you prefer, pause or disableThis is useful if you only want to expose access occasionally or if you manage computers that don't need to be accessible all the time.

How to connect from the browser

With the Pi linked, open connect.raspberrypi.com and log in with your Raspberry Pi ID. You'll see a list of devices and, on each one, a “Connect” button. When you press it, the system will offer you the available modalities for that team.

In general, two options appear: Remote Shell (shell in the browser) and Screen sharing (remote desktop). Remember that the second one depends on Wayland and is limited to Pi 5, Pi 4, and Pi 400 with 64-bit Bookworm, while the remote shell has a wider scope and can work on older boards and systems.

The connection is established within seconds. If there is a viable direct route, WebRTC sets up a peer-to-peer tunnelOtherwise, it relies on relay servers, without sacrificing session encryption. For practical purposes, you only see a new window with your terminal or desktop.

If you work from a mobile or tablet, the remote desktop interface includes controls designed for touch screens, such as special keys accessible from a bottom bar. On desktop computers, you'll enjoy a full keyboard and mouse without any further ado.

Using the Remote Shell

El remote shell It's the most universal and lightweight option: it opens a Pi console directly in your browser. It's ideal for updates, configuration changes, installing packages, or running quick scripts.

To launch it, select the device and press Connect via → Remote ShellAfter a brief channel setup, you'll see the prompt and be able to work as if you were using SSH, but without having to expose ports or know the public IP address.

According to some guides, this modality works even in veteran models like Raspberry Pi 1 and on older systems (compatibility was mentioned up to Buster). If you manage multiple boards of different generations, the shell can become your Toolbox everyday.

For server installations or headless machines, consider enabling the service to be available even without a user login at startup. With a simple command, you'll have Connect always at hand, without depending on the graphical login.

Using Remote Desktop (Screen Sharing)

The function of Screen sharing It gives you the full Pi desktop in your browser. It's designed for computers supported by the current Wayland stack (Pi 5, Pi 4, and Pi 400 with Bookworm 64-bit) and offers a smooth and responsive experience.

To activate it, from the list of devices choose Connect via → Screen Sharing. A window will open with your Pi's desktop; at the top you will see a top bar with a button to disconnect, a lock icon indicating the security of the connection and a clipboard access to copy and paste between devices.

At the bottom another bar appears with hot keys Useful on mobile phones or tablets (e.g., function or special keys). This layer of controls makes it easier to work when you don't have a physical keyboard at hand and improves usability on small screens.

In the current beta there are some limitations: at the moment, It is not possible to share multiple screens at onceIf you use multiple monitors with your Pi, you'll see a single output. It's reasonable to expect future releases to expand these capabilities.

Compared to VNC, the WebRTC connection is very direct and, in many cases, It feels more agilePlus, by managing everything from your Raspberry Pi ID, you save on the hassle of DDNS, ports, or intermediate services that might become outdated.

Useful steps and commands

Install Connect on a Pi with a desktop (if it isn't already): update, install and restart with the usual commands. You'll see the round icon with two dots in the top tray when you return to the desktop.

Desktop Commands sudo apt update
sudo apt upgrade -y
sudo apt install rpi-connect
sudo reboot

Commands for Lite sudo apt update
sudo apt upgrade -y
sudo apt install rpi-connect-lite
sudo reboot

Link from terminal in any edition: run the sign in, open the URL that is printed and complete the process in the browser with your Raspberry Pi account.

Login command rpi-connect signin

Management from the web account

In the online panel you will see all your teams and what type of connectivity each one offers (shell, desktop, or both). This helps you identify at a glance what options are available depending on the model and operating system.

Also, you can rename of the device for better recognition—very useful if you manage multiple boards. Just log in and edit the name field to update it.

If you no longer need a device, you have the option to delete it from the same web interface. This way, you can clean up your inventory and avoid unnecessary access to equipment that's no longer in use.

In the future, we can expect more management features (adding devices from the web, additional customization options), but right now it covers the essentials for keeping your Pis park organized.

Safety and maintenance tips

Active 2FA on your Raspberry Pi ID. It's a critical layer of security, especially since your account governs remote access. Setting it up takes a minute and worth with profit.

If you are using Raspberry Pi OS Lite or there is no automatic login, enable the linger so that Connect is available after startup even if no user is logged in. It's a one-time setting and prevents any surprises.

loginctl enable-linger

Keep the package up to date with a selective installation: you can update only Connect and its Lite variant, so you don't have to touch the rest of the system every time. This balances security, stability, and convenience.

sudo apt update
sudo apt install --only-upgrade rpi-connect

Since this is in beta, please check the official releases and documentation from time to time. If a bug appears, stable version, is likely to arrive with performance improvements, expanded compatibility, and new management options.

Alternatives and considerations

If you need occasional access to the terminal on the local network, SSH It remains unbeatable for its lightness. For a classic desk, VNC It works well, although the configuration could be a bit more verbose and depend on third-party services.

Tools like TeamViewer or similar are valid, but in many cases they are commercial solutions with licenses or restrictions. If you prefer to stay within the official ecosystem, Connect makes life quite simple.

For projects where security and absolute control of the channel are the priority, you can set up a VPN server (OpenVPN or WireGuard), and then log in via SSH or VNC as if you were on a LAN. It's a more technical approach, but with a very high level of protection and autonomy.

Whatever your choice, remember that Connect removes the biggest barrier to entry: Do not touch the router or open portsIn many scenarios, this detail is enough to make remote administration go from being a headache to a routine task.

You already have the full map to get up and running with Raspberry Pi Connect: from requirements and compatibility details to installation, pairing, and daily use in both shell and desktop, plus management options and key security tips; an official, simple, and incredibly powerful solution that lets you control your Pi from anywhere with just a few clicks.