xfreerdp3

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

xfreerdp3 is the X11 Remote Desktop Protocol (RDP) client from FreeRDP 3. It connects to Windows Remote Desktop, xrdp, GNOME Remote Desktop, ogon, VirtualBox VRDP, and other RDP servers.It is the 3.x successor of xfreerdp (FreeRDP 2). Distros that ship both versions name this binary xfreerdp3 so the two can be installed together. Options use FreeRDP's Windows-style syntax: `/flag` enables a flag, `/option:`value sets a value, and `+toggle` / `-toggle` turn a toggle on or off (`/` is a synonym of `+`). A saved `.rdp` file can be passed as the first argument.Graphics, clipboard, drives, printers, smart cards, USB, audio, microphone, and RemoteApp can all be redirected. Network Level Authentication (NLA), TLS, RDP standard security, Azure AD, RD Gateway, and Hyper-V console connections (`/vmconnect`) are supported.

/v: host[:port]

Server hostname, IPv4/IPv6 address, vsock URI, named pipe, or an existing TCP socket. Default port is 3389.

Username. Domain can be prefixed with a backslash (`DOMAIN\user`) or appended after `@`.

Password. Passing `/p` with no value silences interactive prompts when the server needs no credentials. A password on the command line is visible in the process list.

Windows domain.

Server port (alternative to `/v:host:port`).

Fullscreen. Toggle with Ctrl+Alt+Enter.

Window width in pixels (default 1024).

Window height in pixels (default 768).

Screen size. `50%h` uses 50% of the local screen height.

Send resolution updates when the local window is resized (default off). `/dynamic-resolution` is the same toggle.

Enable clipboard redirection (default off). `/clipboard:` accepts sub-options for selection atom and direction.

Redirect local directory path as share name. `/drive:hotplug,*` redirects drives plugged in later.

Audio output redirection. Example: `/sound:sys:alsa`.

Audio input (microphone) redirection.

Certificate policy. ignore skips all checks; tofu accepts the first certificate and rejects later mismatches.

Force a security protocol. `/sec:nla` enables NLA and disables the others.

RD Gateway. Short form: `/gw:`.

Admin (console) session. Alias: `/console`.

RemoteApp (run a single remote program instead of a full desktop).

Redirect matching smart cards.

Redirect a printer.

Redirect a USB device by vendor/product id.

Read credentials from stdin.

Print version.

Print help.

Global certificate policy is JSON at /etc/FreeRDP/certificates.json. The X11 client also reads /etc/FreeRDP/xfreerdp.json (`isActionScriptAllowed` enables or blocks action scripts).An optional action script at `~/.config/freerdp/action.sh` (or `/action-script:`path) receives key combinations and can mark them `key-local` so they are not forwarded to the remote session.`FREERDPASKPASS` selects an askpass program, similar to `SSHASKPASS`. Logging uses wLog; `/log-level` and `/log-filters` override the environment.

Right Ctrl

Release keyboard and mouse grab so local shortcuts work again.

Toggle fullscreen.

Minimize the window.

Disconnect and exit.

Toggle remote control in a remote-assistance session.

A password given with /p: is visible to other users via `ps`. Prefer an interactive prompt, `/from-stdin`, or `FREERDP_ASKPASS`./cert:ignore disables certificate checks entirely. Do not use it on untrusted networks.This is an X11 client. On a pure Wayland session it typically runs through XWayland. FreeRDP 3 also ships wlfreerdp3 (Wayland) and sdl-freerdp3 (SDL) as separate binaries.Keyboard grab (on by default) swallows local compositor shortcuts until Right Ctrl releases it.

FreeRDP is an Apache-licensed RDP implementation that grew out of the earlier rdesktop client. The 3.x series (first released in 2023) is a new ABI; Linux distributions therefore install the X11 frontend as xfreerdp3 alongside the 2.x xfreerdp binary.

xfreerdp(1), rdesktop(1), remmina(1), vinagre(1), vncviewer(1), krdc(1)

Source code · Homepage · Documentation