How to Install and Use XRDP on Ubuntu for Remote Desktop Connection

Brief: This tutorial goes over setting up XRDP on Ubuntu, which will allow for GUI connections to a remote computer.

Microsoft Remote Desktop Protocol (RDP) is a protocol that allows for graphical remote desktop connections from one computer to another. RDP works by having a main machine run software that allows several other computers to connect to it.

XRDP is an open-source implementation of RDP, removing the need to run any proprietary programs. XRDP not only tries to follow in the direction of RDP, but is also compatible with regular RDP clients such as Remmina and GNOME Boxes.

XRDP features a simple one-page interface, after which you’ll be right at your desktop:

xrdp connected login

Things to keep in mind about using XRDP

While XRDP works great for getting remote access to machine, it’s important to know what XRDP isn’t good at.

Do not use XRDP if you need a secure connection

Connections made over XRDP can be viewed and modified by attackers, and should thus be avoided for any sensitive information. This can be alleviated through the use of an SSH connection or with certificates, but both require a more complex setup and will not be covered here.

XRDP doesn’t work well with theming by default

In my testing, XRDP didn’t ever seem to apply the theming Ubuntu comes with by default. Instructions for fixing this are available at the end of the article.

Don’t use XRDP if you only want/need a CLI environment

XRDP is designed and made to use in a GUI environment. If you plan on using it for a CLI environment, such as on a server, you should look at other tools, such as SSH.

Installing and Setting Up XRDP on Ubuntu

This tutorial assumes the following setup to get everything working properly.

  • A Linux system with the XRDP server software installed on it. This is the system which will be accessed remotely.
  • If the remove machine isn’t on your local network, the machine will need a public IP address with port forwarding enabled.
  • The username and password of the remote system.
  • Another system (be it Linux, Windows, or macOS) with an RDP client installed.
xrdp ubuntu

Step 1: Install XRDP on the remote machine

Installing XRDP is just a couple of steps, and is pretty straightforward to do.


Before going anywhere, note that the “remote machine” will be the machine that all others connect to.

XRDP is included in most distributions’ repositories. On Ubuntu, it is available in the universe repository.

You can install it with the following command:

sudo apt install xrdp

Step 2: Connecting to the remote machine

Good news is XRDP works right out of the box!

To connect to the machine you installed XRDP on, you’ll first need to install an RDP client on your local machine.

I’ll be using GNOME Boxes, which can be installed with the following:

sudo apt install gnome-boxes

GNOME Boxes is known more for virtual machine use, but it also supports a variety of other protocols, including XRDP.

If for whatever reason you don’t want to use Boxes, you can also use a client called Remmina:

sudo apt install remmina

Again though, note that I’ll be using Boxes throughout the rest of the tutorial.z

First off, Start GNOME Boxes, and click on the + sign and select “Connect to a Remote Computer…“.

xrdp gnome boxes connect begin

Next, enter the IP address of the machine you’re connecting to, prefixed with rdp://, and then connect as shown below:

Not sure what your IP address is?

You can find your IP address with the ip address command. You’ll need to look for something that looks like a number split into four groups:

abhishek@its-foss:~$ ip address
1: lo: mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000
link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
inet scope host lo
valid_lft forever preferred_lft forever
2: wlp0s20f3: mtu 1500 qdisc noqueue state UP group default qlen 1000
link/ether dc:46:b9:fb:7a:c5 brd ff:ff:ff:ff:ff:ff
inet brd scope global dynamic noprefixroute wlp0s20f3
valid_lft 6183sec preferred_lft 6183sec

Avoid any IP addresses named, as that one points back to the machine you ran the command on. There should be more IP addresses in the output, as shown above.

xrdp gnome boxes rdp connect

You should then be presented with a login screen. Keep “Session” set to “Xorg”, and just enter your username and password, then click “OK”:

xrdp connected login

After, you should be presented with the desktop of the remote machine:

xrdp connected homescreen

And now you’re good to go! Everything will behave just the same as if the machine was right in front of you.

Troubleshooting: Fixing theming issues

XRDP never seemed to get the theming correct for me. This can be fixed with a few steps.

First, on the remote computer, run the following command:

sudo apt install gnome-tweaks gnome-shell-extensions dconf-editor -y

Next, open the Extensions app, and turn on the toggles shown below:

xrdp extensions

Now, close your remote desktop session and log back in. Next, open up Tweaks and configure everything per the screenshot below:

xrdp tweaks

Lastly, open up dconf Editor, and navigate to /org/gnome/shell/extensions/dash-to-dock/, and set the values that are shown below:

  • custom-theme-shrink: On
  • dock-fixed: On
  • transparency-mode: FIXED

Wrapping Up

And there you go! Everything is good to go, ready to do what you need to.

If something isn’t working quite right, or you have any questions or comments, feel free to leave them below.

About the author
Hunter Wittenborn

Hunter Wittenborn

Sole Linux user with Ubuntu running my desktops and servers. I do some music stuff in my free time, mainly with piano.

Become a Better Linux User

With the FOSS Weekly Newsletter, you learn useful Linux tips, discover applications, explore new distros and stay updated with the latest from Linux world


Great! You’ve successfully signed up.

Welcome back! You've successfully signed in.

You've successfully subscribed to It's FOSS.

Success! Check your email for magic link to sign-in.

Success! Your billing info has been updated.

Your billing was not updated.