xRDP – How to Install on Linux Mint – Part I


Hello World,

As announced in our previous post, we are starting a series of post related to xRDP software and how to install it on different Ubuntu flavors.  Today, we will show you how you can install the xRDP software package on a Linux Mint 18.1.  

The recent release of Linux Mint 18.1 makes it a perfect candidate for an xRDP instructions guide plus multiple people asked us about xRDP and Linux Mint. 

So, hear we go….

xRDP on Linux Mint 18.1


When we have performed our installation & testing, we have been using the following infrastructure

  • We have performed a Fresh installation of the Linux Mint 18.1
  • We have performed the installation on a Virtual Machine running on Hyper-V Server and Virtualbox

We are assuming that

  • Your Linux Mint machine is connected to Internet (so you can download the necessary packages for the installation to occur). If you are not connected to internet, you will have to manually download the necessary packages and make them available on your offline machine

Installation Process 

Step 1 – Install xRDP package

At this stage, you should have a Linux Mint machine installed and ready to be used.  


Click on Picture for Better Resolution

Once logged onto the system, open a terminal and issue the following command 

sudo apt-get install xrdp 


Click on Picture for Better Resolution

Wait for the installation to complete. At the end of the process, check the version of xRDP installed on your system by issuing the command

xrdp -v  

As you can see in the screenshot, the version is 0.6.1.  


Click on Picture for Better Resolution


At this stage, you would think that you are ready to go.  This is not the case.  If you try to perform a remote desktop session to your Linux Mint machine, nothing will happen or you will end up with the following error  


Click on Picture for Better Resolution

In Linux Mint, this is a normal behavior because no VNC Server is being installed along with the xRDP package. This means that we need to install an additional package to establish a remote desktop session… 

Step 2 – Install TigerVnc Server package

In order to connect to the Cinnamon interface through the xRDP software, it’s necessary to install a specific VNC Server package :

  • the TigerVNC server software.  


The TigerVNC Software is not available in the Ubuntu repository. You will need to download the installation package from the following location : https://bintray.com/tigervnc/stable/tigervnc/1.7.0#files/


Click on Picture for Better Resolution

After you have downloaded the package, Open a Terminal console and move to your Download folders (or location where you have saved the packaged downloaded above)

cd Downloads

In the terminal console, to perform the installation, type the following

sudo dpkg -i tigervncserver_1.7.0-lubuntu1_amd64.deb


Click on Picture for Better Resolution

You might see some warning and errors messages. Ignore these messages for the moment…


Click on Picture for Better Resolution

To ensure that all the dependencies are installed, issue the following command in the Terminal console

sudo apt-get install -f


Click on Picture for Better Resolution


Step 3 – Configure the xRDP keyboard Settings

Note :  You need to perform this action on the local Ubuntu machine (and not through the xrdp connection !!)

By default, the xRDP login screen will use an en-us keyboard layout. You remote session will also be using the en-us keyboard layout.  If you are using a different keyboard layout than the english one, you might want to use your actual keyboard layout and not the english us one.  

To configure you keyboard layout settings, in your terminal console; simply copy/paste this text and it will try to find out automatically your keyboard layout

# Set keyboard layout in xrdp sessions 
cd /etc/xrdp 
test=$(setxkbmap -query | awk -F":" '/layout/ {print $2}') 
echo "your current keyboard layout is.." $test
setxkbmap -layout $test 
sudo cp /etc/xrdp/km-0409.ini /etc/xrdp/km-0409.ini.bak 
sudo xrdp-genkeymap km-0409.ini


At this stage, you are done and ready to work

Perform the remote Connection 

At this stage, you should be able to perform a remote desktop session to your Linux Mint machine.  The first time you login, you might receive a message error.  If you try the second time, you should be presented with your Cinnamon Desktop environment and you can start working on your Linux Mint. 


Click on Picture for Better Resolution


As already mentioned, you will be connected to your cinnamon desktop interface but it’s not the full one. In the screenshot above, you see that you are logged on in the software rendering version of cinnamon. 

Final Notes

This is the end of this post.  As you can see, if you install the xrdp package and the tigerVNC server software, you should be able to remote connect to your Linux Mint Operating System.  However, we will investigate a little bit further xRDP and Linux Mint topic. Indeed, in this post, we have been using the xrdp package version 0.6.1.   A newer version is available (0.9.0) which ships by default in Ubuntu 16.10

In the second part, we will see how we can install the xrdp version 0.9.0 on Linux Mint which bring more features and settings than xRDP 0.6.1 

Stay Tuned 

Till next time 

See ya

14 thoughts on “xRDP – How to Install on Linux Mint – Part I

  1. Hello and thanks for the info!
    I’ve now tried 3 of the RDP tutorials on your site with some limited success. I am able to get connected but with woefully slow speed. Is there any way I can adjust something to make it run faster? It’s like a 5 second lag, and this server has gig internet.

  2. @DaveT

    What do you call limited success ? Please provide more information about what you are trying to achieve, Which distribution you are using, which desktop environment you want to use, which version of xrdp you are using as well

    Xrdp is not superfast but performance are usually good enough to perform your job through the remote session

    Waiting for some feedback
    Till next time
    See ya

  3. Thank you so much! I’ve fought with this kind of thing for a while. You make it simple!

  4. @Aaron,

    Thank you for the positive feedback. We too had to fight for a long time to get stuff working with XRDP…:-). We hope that the info provided through this blog is somewhat useful…

    Till next time
    See ya

  5. Thanks mate, did manage but I still have a small problem, my keyboard works well in applications however when I use in terminal and search box it’s completely srewed.

  6. @Stephen,

    We are not using extensively Linux Mint so could not help you here…. we would need to install it and check for this…. to solve your issue, you could try to perform a custom installation of xrdp….
    You can have a look at part II of the post and use the script. HOWEVER, you would need to tweak the script as the latest xrdp binaries have introduced important changes….You cannot use it as is (you have a look at the script in this post – see http://c-nergy.be/blog/?p=10752 – as a base as this one is the most recent and should work with the latest xrdp binarie….

    Use it at your own risk and test it before in a standalone or virtual machine

    Hope this help
    Till next time

  7. Thanks for the post, got me past the ‘error – problem connecting’ issue.

    However, now it gets through to the ‘connected ok’ and the RDP window closes. I thought that it might have been the resolution of my client (3440×1440) but I tried from a VM with a 1024×768 resolution and got the same thing. Any guidance would be appreciated.

  8. @Derek,

    We are working on that… Several people have noticed that a change has occurred in xRDP or UBuntu Operating system that generate this behavior. Some fixes are already available from Ubuntu.. We will try to publish asap information and workaround about the issue

    Stay tuned
    Till next time

  9. Cinnamon desktop wont come up.
    This works:
    echo xfce4-session >~/.xsession
    This doesn’t:
    echo cinnamon >~/.xsession

  10. @Bert,
    Ok Thank you for he feedback… As we are not regular users of Linux Mint, we might investigate this issue when time permit
    Till next time
    See ya

  11. Hi, I tried this but Windows RDP doesn’t connect to my Linux server it just times out and returns this error:

    Remote Desktop can’t connect to the remote computer for one of these reasons:
    1) Remote access to the server is not enabled
    2) The remote computer is turned off
    3) The remote computer is not available on the network

    I double-checked and none of these is true

  12. @William
    I was getting this as well and it appears to have been the firewall on my linux machine.
    I opened port 3389 for xRDP:
    # firewall-cmd –permanent –add-port=3389/tcp
    but forgot to reload:
    # firewall-cmd –reload

    However, I am now getting another error that seems pretty vague. I have a feeling it has to do with TigerVNC, which I am reading is required to be able to connect to the Cinnamon UI. I am not 100% sure on this though; my Linux knowledge is limited and I pretty much learn as I go and try to document everything I can.

  13. Thanks Donnie I did that and now I can log in but with another problem. After my computer goes to sleep or the session ends, I get a blank screen after I re-log into the xrdp session.

  14. @William,

    xRdP is not the perfect solution but can be really helpful in mixed environement…
    Hope you succeeded with your installation and confiuration
    Till next time
    See ya

Leave a Reply