Difference between revisions of "Xrdp"

From Univention Wiki

Jump to: navigation, search
(Moved content to official documentation)
Line 1: Line 1:
{{Version|UCS=3.0}}
+
Article has been moved to UCS documentation: https://docs.software-univention.de/handbuch-4.3.html#computers:xrdp
= Overview  =
 
 
 
{{App Center Available|xrdp}}
 
[[File:xrdp.png|200px|thumb|right|XRDP login screen]]
 
 
 
XRDP is a daemon running on UCS, which allows users to open a X session on the server using the Remote Desktop Protocol (RDP). This protocol is natively supported by Microsoft Windows and many other operating systems and thus does not require additional software to be installed on the client PCs.
 
 
 
= Installation  =
 
 
 
XRDP is available through the [https://www.univention.com/products/univention-app-center/ App Center] and can be installed using the corresponding UMC App Center module.
 
 
 
= Configuration  =
 
 
 
== Allowed users ==
 
By default all users of the UNIX group ''Domain Admins'' are allowed to connect using RDP. The name of the group can be changed by setting the UCR variable ''xrdp/access/admins''.
 
 
 
== Maximum number of concurrent sessions ==
 
The maximum number of concurrently running RDP sessions is by default limited to 10 and can be changed using the UCR variable ''xrdp/sessions/max''.
 
 
 
== Login window customization ==
 
The title and the images used in the login windows can be configured using the UCR variables ''xrdp/title'' and ''xrdp/imagedir''.
 
 
 
The directory must contain 4 images using the Windows bitmap format.
 
The first two are used as the rectangular logo at the left side on the input fields, the other two are used for the banner displayed below the input window:
 
;ad24b.bmp:  24 bit color logo, 140 x 140
 
;ad256.bmp:  256 color logo, 140 x 140
 
;xrdp24b.bmp: 24 bit color banner, 256 x 192
 
;xrdp256.bmp: 256 color banner, 256 x 192
 
 
 
= Client Software  =
 
 
 
* Microsoft Windows has a built-in RDP client. It will show a certificate warning as long as the UCS certificate has not been imported.
 
* UCS and many other Linux distributions include [http://www.rdesktop.org/ rdesktop] and [http://www.freerdp.com/ FreeRDP].
 
* For Apple iOS there is [http://www.irdesktop.com/ iResktop].
 
* For Android there are [https://play.google.com/store/search?q=rdp+client&c=apps multiple apps].
 
 
 
= Known Issues  =
 
 
 
== Wrong keyboard layout  ==
 
 
 
When you log into KDE using XRDP, the keyboard is configured to use the US layout by default. To change this open the K-Menu, switch to the ''Computer'' tab, open ''System settings'', then open the ''Regional & Languages'' in the ''Personal'' section. There open ''Keyboard Layout'', select ''Enable keyboard layouts'' and add the requested layout from the left list of available layouts. Click the right arrow to add the layout and reorder it to the top in the right list of ''Active layouts'' using the up/down buttons. Apply the changes and close the application.
 
 
 
= Alternatives  =
 
 
 
;VNC
 
:Virtual Network Connect provides a simpler protocol, which is used by KVM for example.
 
;ssh
 
:only provides a text console by default, but can be used to tunnel X sessions natively.
 
 
 
= Links =
 
 
 
*[http://www.xrdp.org/ www.xrdp.org/] Homepage of the XRDP project
 
*[https://github.com/FreeRDP/FreeRDP/wiki/Keyboard github.com/FreeRDP/FreeRDP/wiki/Keyboard] Background information about the keyboard layout problem
 

Revision as of 07:13, 3 May 2018

Article has been moved to UCS documentation: https://docs.software-univention.de/handbuch-4.3.html#computers:xrdp

Personal tools