xpra icon
Bug tracker and wiki

This bug tracker and wiki are being discontinued
please use https://github.com/Xpra-org/xpra instead.

We have moved

This page has been moved to https://github.com/Xpra-org/xpra/blob/master/docs/Usage/Start-Desktop.md

Archived copy:

Desktop Mode


Version 1.0 adds support for "desktop mode", which is the ability to run a full desktop session in a window instead of having each individual window forwarded separately. This feature requires X11 server support is not available on Mac OSX servers.

This behaviour is similar to VNC, but with the added benefits of the xpra protocol: sound, printer forwarding, etc. (see wiki/Features)

You can also connect using VNC clients, see wiki/RFB.


To start a desktop session simply run:

xpra start-desktop --start=xterm

Then connect as usual from the client.

Alternatively, you can start a session and connect in one command from the client using the ssh syntax:

xpra start-desktop --start=xterm ssh:HOST

Window Manager or Desktop Environment

In order to run a window manager or even a full desktop environment within this desktop session, simply replace the "xterm" example above with the command that starts the WM or DE of your choice, ie for "fluxbox":

xpra start-desktop --start=fluxbox

Desktop Size

By default the desktop size will start using a screen resolution of 1920x1080, this virtual screen can be resized at any point using regular X11 tools (ie: "xrandr").

To change the initial desktop size, add a start command:

xpra start-desktop --start="xrandr -s 1024x768" --start=fluxbox

Starting with xpra server version 2.1, the remote desktop can be resized simply by resizing the window. (#1557)

(the randr extension may not work on some Ubuntu releases, see wiki/Xdummy for details)

Last modified 17 months ago Last modified on 02/06/21 13:51:19