Cool Solution - FreeRDP on UCC

From Univention Wiki

Revision as of 10:37, 7 April 2014 by Smidt (talk | contribs)
Jump to: navigation, search
Note: This article is not yet reviewed.
{{Cool Solutions Disclaimer|Repository=yes|UCC=1.0}

This article describes how to install the latest git-packaged version (at the time of writing it was version 1.1.0 from July 21st, 2013) of FreeRDP and XRDP on a Univention Corporate Client (UCC). This version differs from the standard UCS FreeRDP mainly in the new command-line parameters and the enhanced JPEG compression.

Attention: This release is alpha! This means that errors can occur, which might lead to data loss!

Adding the repository

The UCC cool solution repository must be added to the UCC system according to Howtos UCC 1.0

Note: Be advised, that the repository contains both the XRDP server and the FreeRDP client.


On the client, after adding the repository to the system, the FreeRDP client can be installed by:

apt-get update
apt-get install freerdp-x11

Apt will install all needed dependencies.


The client offers no configuration files and is configured on the fly during its execution. This version (1.1.x) differs from the 1.0.* version line mainly in adding the parameters to the executioning call. In the latter, parameters were added by using the dash (-), this had been changed by using the slash (/). In this version an internal wrapper will take care of switching the old parameters to the new ones.

Note: Be advised that this version of FreeRDP was not tested properly using Thin Clients!
Note: Be advised that, despite the current version bringing a parameter wrapper, scripts containing FreeRDP calls should be checked manually!

Configuration examples

Old syntax new syntax Explanation
xfreerdp <server> xfreerdp /v:<server> Connecting to a server without any configuration.
xfreerdp -g 1024x768 <server> xfreerdp /w:1024 /h:768 /v:<server> Setting a different absolute screen resolution.
xfreerdp -g 80% <server> xfreerdp /size:80% /v:<server> Setting a different relative screen resolution.
xfreerdp -u <username> -p <password> -d <domain> <server> xfreerdp /u:<username> /p:<password> /d:<domain> /v:<server> Logging in with user credentials.
xfreerdp -x m/b/l <server> xfreerdp /network modem/broadband /v:<server> Setting the performance flag. Please not that the l-flag is deprecated.
xfreerdp -z <server> xfreerdp /compression /v:<server> Enabling compression.
Personal tools