Skip to content
akallabeth edited this page Mar 20, 2025 · 24 revisions

Connect takes a very long time (~1 minute)

  1. there are entries like [07:00:01:911] [1076502:00106d17] [ERROR][com.winpr.sspi.Kerberos] - [kerberos_AcquireCredentialsHandleA]: krb5glue_get_init_creds (Cannot find KDC for realm "YY" [-1765328230]) ?

-> check your /etc/krb5.conf. FreeRDP now supports kerberos authentication and from bug reports we know that there are a lot of systems with broken KDC entries that are not reachable around.

  • Remove these entries and the kerberos connect will fail fast and you will no longer see such delays.
  • if you do not use kerberos anywhere else you can also just remove the file (an empty configuration is fine for FreeRDP) (best rename the file so you can switch back if you should need it again)

-> There was a report that DNS with HighAvailability broker setups is not kerberos friendly, see https://github.com/FreeRDP/FreeRDP/issues/6508

-> If nothing else helps you can try /auth-pkg-list:!kerberos (or '/auth-pkg-list:!kerberos' if you need to escape !)

Windows 7 (ERRCONNECT_TLS_CONNECT_FAILED)

Windows 7 uses outdated sha1 hash for certificates. This is disabled by modern linux systems, so you can not connect with a failure of ERRCONNECT_TLS_CONNECT_FAILED

  • Try adding /tls-seclevel:1 ( or /tls-seclevel:0 depending on distribution) to enable OpenSSL legacy and a security level low enough for the connection to work

NOTE: With FreeRDP 3.x the command changed to /tls:seclevel:0

ERRCONNECT_TLS_CONNECT_FAILED

If you have issues and the above fix does not help try to check if your openssl can connect to the target with

openssl s_client -connect server.name:3389

if that command fails to establish a connection it might be due to:

  1. No network connection between the host and target
  2. No RDP server running on the target (or blocked by firewall rules)
  3. No common ciphers supported (for example, the server uses outdated TLS 1.0 while you are on latest & greatest SSL which do no longer allow TLS 1.0)

Mouse Wheel not working with wlfreerdp under KDE/Wayland

It is necessary to put the scrolling speed to 5 or higher in the KDE mouse settings. Otherwise there is a weird behaviour, that scrolling is not recognized by MS-Windows.

Originally posted by @0140454 in https://github.com/FreeRDP/FreeRDP/issues/6766#issuecomment-769016036

Azure / Office 365 Credentials

Use /u:.\\AzureAD\\[email protected] or /u:'.\AzureAD\[email protected]' (captioned by the '')

See https://github.com/FreeRDP/FreeRDP/issues/5972

Connect to Azure Virtual Desktop (AVD)

You will need at least FreeRDP 3.0-beta or a upstream developement build

First you need to get the rdpw file from the webportal.

Log into https://client.wvd.microsoft.com/arm/webclient/v2/index.html

Set the resource launch method to "Download the rdp file" screenshot

Then you can launch the session by calling

freerdp <path to rdpw.rdpw> /gateway:type:arm /u:<username>

or

freerdp <path to rdpw.rdpw> /gateway:type:arm /sec:aad

The username is usually the same format as the Office 365 Credentials above. Sometimes only /sec:aad works

FreeRDP shipped with my distribution is rather old - is there a recent version?

The FreeRDP team provides nightly builds for some distributions have a look to Pre-Builds.

For ubuntu it is also possible to use remmina which is shipping their own build of freerdp

For other distributions are currently no daily packages available so you will need to build from source - see compilation.

I am experiencing severe audio lag when viewing multimedia content.

Further reading:

For v1.0.x

Use the --data latency:X -- argument to specify the audio latency. X is in milliseconds.

Example command line:

xfreerdp -u user --no-nla -f --plugin rdpsnd --data latency:50 -- 192.168.x.x

Windows client does not provide any output

Windows does not allow terminal output from an application. Try wfreerdp.exe >log.txt 2>&1 to redirect the output to a file.

Clone this wiki locally