xfreerdp(1) FreeRDP X11 client


xfreerdp [file] [options] [/v:server[:port]]


xfreerdp is an X11 Remote Desktop Protocol (RDP) client which is part of the FreeRDP project. An RDP server is built-in to many editions of Windows. Alternative servers included xrdp and VRDP (VirtualBox).


/v <server>[:port]

Server hostname

/port <number>

Server port

/w <width>


/h <height>


/size <width>x<height>

Screen size


Fullscreen mode

/bpp <depth>

Session bpp (color depth)

/kbd 0x<layout id> or <layout name>

Keyboard layout


List keyboard layouts

/kbd-type <type id>

Keyboard type

/kbd-subtype <subtype id>

Keyboard subtype

/kbd-fn-key <function key count>

Keyboard function key count


Admin (or console) session


Use multiple monitors


Use available work area

/monitors <0,1,2...>

Select monitors to use


List detected monitors

/t <title>

Window title


Window decorations


Scale remote desktop to window size

/a (null)


/vc (null)

Static virtual channel

/dvc (null)

Dynamic virtual channel

/u [<domain>\]<user> or <user>[@<domain>]


/p <password>


/d <domain>



Gateway Hostname

/gu [<domain>\]<user> or <user>[@<domain>]

Gateway username

/gp <password>

Gateway password

/gd <domain>

Gateway domain

/load-balance-info <info string>

Load balance info

/app ||<alias> or <executable path>

Remote application program

/app-name <app name>

Remote application name for user interface

/app-icon <icon path>

Remote application icon for user interface

/app-cmd <parameters>

Remote application command-line parameters

/app-file <file name>

File to open with remote application

/app-guid <app guid>

Remote application GUID



/shell (null)

Alternate shell

/shell-dir (null)

Shell working directory


Audio output (sound)


Audio input (microphone)

/audio-mode (null)

Audio output mode


Redirect multimedia (video)

/network (null)

Network connection type

/drive (null)

Redirect drive


Redirect all drives


Redirect home drive


Redirect clipboard

/serial (null)

Redirect serial device

/parallel (null)

Redirect parallel device

/smartcard (null)

Redirect smartcard device


Redirect printer device

/usb (null)

Redirect USB device


Redirect multitouch input


Echo channel


Smooth fonts (ClearType)


Desktop composition


Full window drag


Menu animations





/gdi <sw|hw>

GDI rendering



/rfx-mode <image|video>

RemoteFX mode

/frame-ack <number>

Frame acknowledgement




JPEG codec

/jpeg-quality <percentage>

JPEG quality


protocol security negotiation

/sec <rdp|tls|nla|ext>

force specific protocol security


rdp protocol security


tls protocol security


nla protocol security


nla extended protocol security

/cert-name <name>

certificate name


ignore certificate

/pcb <blob>

Preconnection Blob

/pcid <id>

Preconnection Id


Hyper-V console (use port 2179, disable negotiation)


authentication (hack!)


encryption (hack!)


grab keyboard


Alt+Ctrl+Enter toggles fullscreen



/parent-window <window id>

Parent window id


bitmap cache


offscreen bitmap cache


glyph cache

/codec-cache <rfx|nsc|jpeg>

bitmap codec cache


fast-path input/output


maximum fast-path update size


asynchronous input


asynchronous update


asynchronous transport (unstable)


asynchronous channels (unstable)

/wm-class <class name>

set the WM_CLASS hint for the window instance


print version


print help

/play-rfx <pcap file>

Replay rfx pcap file


Authenticate only.


xfreerdp connection.rdp /p:Pwd123! /f

Connect in fullscreen mode using a stored configuration connection.rdp and the password Pwd123!

xfreerdp /u:CONTOSO\\JohnDoe /p:Pwd123! /v:rdp.contoso.com

Connect to host rdp.contoso.com with user CONTOSO\\JohnDoe and password Pwd123!

xfreerdp /u:JohnDoe /p:Pwd123! /w:1366 /h:768 /v:

Connect to host on port 4489 with user JohnDoe, password Pwd123!. The screen width is set to 1366 and the height to 768

xfreerdp /u:JohnDoe /p:Pwd123! /vmconnect:C824F53E-95D2-46C6-9A18-23A5BB403532 /v:192.168. 1.100

Establish a connection to host with user JohnDoe, password Pwd123! and connect to Hyper-V console (use port 2179, disable negotiation) with VMID C824F53E-95D2-46C6-9A18-23A5BB403532


Activate clipboard redirection


Activate drive redirection of /home/user as home drive


Activate smartcard redirection for device device


Activate printer redirection for printer device using driver driver


Activate serial port redirection for port device


Activate parallel port redirection for port device


Activate audio output redirection using device sys:alsa


Activate audio input redirection using device sys:alsa


Activate multimedia redirection using device sys:alsa


Activate USB device redirection for the device identified by 054c:0268




The FreeRDP Team