How to configure the xRDP server on Ubuntu Linux?

How to configure the xRDP server on Ubuntu Linux?

This tutorial describes how to set up an xRDP server to connect to Ubuntu Linux with the lightweight graphical Xforce UI using the RDP protocol. This can be very handy when you need to connect to Linux operating systems with graphical interface from Windows using Remote Desktop.

What is xRDP?

xRDP is Microsoft’s free and open-source implementation of RDP (Remote Desktop Protocol) which allows non-Microsoft Windows operating systems (such as Linux and BSD) to provide a fully functional RDP-compatible remote desktop.

Installation and Setup

Connect to your ubuntu server via SSH and perform a system update:

sudo apt-get update

sudo apt-get upgrade -y

Install and enable the xRDP utility:

sudo apt-get install xrdp

sudo systemctl enable xrdp

sudo systemctl restart xrdp

Xrdp Installation

Install the xfce environment:

sudo apt-get install xfce4 xfce4-terminal

Open RDP port to be able to connect remotely:

sudo ufw allow 3389/tcp

Reboot the xRDP server for the changes to take effect:

sudo /etc/init.d/xrdp restart

Connecting to an Ubuntu Server via RDP

If you don’t know the IP address of the Ubuntu server, you can check it by entering the command:

Ifconfig -a

Ifconfig -a

In our test case it is To connect open the Windows Remote Desktop Connection (mstsc.exe). Enter the IP address of the server and click Connect:

Remote Desktop Connection

A security warning will appear. Click Yes:

RDP Certificate Error

In the opened window, select Xorg as the session, enter the username and password for the user and click OK:

Xrdp Login

This will connect to the xforce desktop.

Xforce Desktop

If it shows a black screen when connecting to xrdp you need to go into the /etc/xrdp folder, and make changes to the file.

sudo nano /etc/xrdp/

We need to add:



Before the line:

test -x /etc/X11/Xsession && exec /etc/X11/Xsession

Troubleshooting Errors with Xrdp

After making the changes you have to restart the XRDP service:

sudo systemctl restart xrdp

Now you can run mstsc.exe again and connect to our ubuntu server.

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.