xrdp ansible role

Set up Xrdp, free and open-source implementation of Microsoft RDP server

Requirements & Dependencies

Ansible

It was tested on the following versions:

2.10

Operating systems

Tested on Ubuntu 18.04, 20.04, Centos 7 and 8.

Example Playbook

Just include this role in your list. For example

- host: myhost
  roles:
    - juju4.xrdp

you probably want to review variables

Variables

xrdp_startwm: 'lxde'
# xrdp_startwm: 'xfce'
# xrdp_startwm: 'gnome'
# xrdp_startwm: 'exec /bin/sh /etc/X11/Xsession'  # whatever custom value

xrdp_enablesyslog: false

Continuous integration

This role has a molecule test suite and github action workflow.

$ pip install molecule docker
$ molecule test
$ MOLECULE_DISTRO=ubuntu:20.04 molecule test --destroy=never

Troubleshooting & Known issues

xrdp requires a complex password (3 of lower, upper, number, special characters) else you may get login failed error. if error persist, try redefining user password just to be sure.
xrdp can use X11, VNC or other interfaces. Those must be present and working.
it is recommended to adapt your window manager to your network bandwidth, eg prefer lxde if low bandwidth.
Misc references
on xrdp speed, see neutrinolabs/xrdp#386 neutrinolabs/xrdp#501 https://askubuntu.com/questions/1323601/xrdp-is-quite-slow

License

BSD 2-clause

juju4/ansible-xrdp