xpra icon
Bug tracker and wiki

Version 63 (modified by Antoine Martin, 4 years ago) (diff)



Platform specific index:

General Information

Before attempting to build from source, make sure that all the required dependencies are installed.

For running the *nix server, you will need Xvfb or Xdummy (if available for your platform), xauth, keyboard utilities. Then just:

  • download the source
  • run:
    python2 ./setup.py install

Do not mix source installation with packages. Remove one completely before installing the other.


There are a number of build switches, which you can see with:

./setup.py --help

These should be auto-detected in most cases.

Many of those switches are related to picture encodings. On some platforms with older versions of libraries, it is possible, preferable and often mandatory to build static versions of the codecs. (see "--with-static*" flags)


There are a number of patches in the source tree that may need to be applied to build on some platforms to deal with library or tools compatibility.

In particular, for Debian: browser/xpra/trunk/debian/patches/


Building with distutils

For installing into a local ./install directory as a normal user, simply run:

./setup.py install --home=./install

You then have to add the local installation directory to your PYTHONPATH whenever you want to use xpra:

PYTHONPATH=./install/lib*/python xpra ...

To install globally for all users via sudo:

rm -rf build install
sudo ./setup.py install



setuptools/distutils do not provide any uninstallation mechanism, this has nothing to do with Xpra. That said, it is generally enough to remove (but you must ensure that these are the correct files as you may damage your system otherwise!):




The xpra ebuilds in portage are reasonably up to date, just avoid the outdated versions shipped as "stable"


Arch Linux

  • Package build for stable versions can be found here
  • The bleeding edge svn build is here


Just follow the generic instructions above and make sure to apply patches where needed.
For example, raspbian: Compiling xpra for the Raspberry Pi - but make sure to install globally with sudo ./setup.py install rather than dealing with unusual install paths.