# Building Xpra

## Platform specific instructions:

Please refer to the instructions most appropriate for your build platform:

- Fedora, CentOS / RHEL
- Debian and Ubuntu
- MS Windows
- MacOS
- Others

## Download the xpra source code

Use one of the following locations:

- `github`: https://github.com/Xpra-org/xpra and https://github.com/Xpra-org/xpra-html5
- `pypi`: https://pypi.org/project/xpra/ (releases only)
- `xpra.org`: https://xpra.org/src/ (releases only)

## Build

First, make sure that all the required dependencies are installed, then:

    git clone https://github.com/Xpra-org/xpra
    cd xpra
    python3 ./setup.py install --prefix=/usr --single-version-externally-managed --root=/
    cp fs/bin/xpra* fs/bin/run_scaled /usr/bin/

## Caveats

- Do not mix source installation with binary packages. Remove one completely before installing the other
- Current versions of xpra require python3, for python2 use the 3.x LTS branch - see versions
- the last step installs xpra's own scripts, replacing the unusable ones mangled by setuptools