Using with Windows Remote Desktop (RDP) and the Raspberry Pi

These instructions tell you how to view and control your Raspberry Pi from a remote location using a Windows computer and Remote Desktop (RDP).  Many versions of Windows include the Windows Remote Desktop client which means you can connect to your Raspberry Pi’s graphical desktop easily without installing any software on the Windows computer.

Summary: These instructions show you how to install xrdp on your Raspberry Pi to allow a network connection from a Windows PC running Windows Remote Desktop.  Next, you’ll learn how to configure a Service that is compatible with xrdp so that you can easily connect to your Pi from outside of your local network.

Before you start:  Create a free account.  Then install onto your Raspberry Pi.

Works With:

  • Devices: Raspberry Pi running the Raspbian operating system..
  • Clients: Windows 7, 8.x, 10.

Installing the xrdp Windows Remote Desktop service on your Raspberry Pi

In a terminal window on your Raspberry Pi, run the following commands:

sudo apt-get update
sudo apt-get install xrdp

Next, confirm that xrdp is in fact running with the command:

ps ax | grep xrdp

You should see something similar to the image above.  The first column of numbers on the left is likely to be different.

Adding a Service Attachment for xrdp

Run the configuration script:

sudo weavedinstaller

At the Main Menu, install a new Service Attachment for xrdp using Custom TCP, non-web, port 3389.

When you’ve successfully installed xrdp and the xrdp service attachment, the Main Menu will include an xrdp entry as shown above.

Using Remote Desktop Connection with

To connect, sign in to your account and locate the Service you just installed in the Service List.

Click on the service name to initiate the connection.  In a few seconds you’ll see the Device Services dialog box:

Select the rdp connection you just registered, then click on "Confirm".

Start the Remote Desktop application, copy and paste the address from the dialog to the “Computer” field as shown in the example below (using the values that are displayed when the connection dialog box appears), then click on “Connect”.


When you see the security warning, click on “Yes” to continue.


At the xrdp login screen, enter your Pi’s user name and password (default pi/raspberry), then click on “Ok”.


Now you are controlling your Raspberry Pi’s GUI!

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request


Article is closed for comments.