Skip to content

Download

Jump to bottom
Antoine Martin edited this page Apr 14, 2024 · 62 revisions

Download

Downloads are listed here for all the supported platforms.
For most use cases, you can install any supported version on both client and server.

The source can be downloaded directly from https://github.com/Xpra-org/xpra, or using release snapshots:

Authentication Signatures

All the binary downloads are signed using the PGP key https://xpra.org/xpra.asc aka F18AD6BB, the key fingerprint is B499 3B57 3231 48E3 7977 E5D8 7325 4CAD 1797 8FAF. For rather tedious reasons, you may need to import two almost identical versions of this key to use the repositories on Debian systems.

MS Windows Microsoft Windows

The microsoft windows download directory contains:

Format Purpose
EXE General purpose installer
MSI alternative installer for unattended installations
ZIP local installation without administrative rights
Format Light Build GPG Signature Full Build GPG Signature
EXE Xpra-Light-x86_64_Setup.exe authentication icon Xpra-x86_64_Setup.exe authentication icon
MSI Xpra-Light-x86_64.msi authentication icon Xpra-Light-x86_64.msi authentication icon
ZIP Xpra-Light.zip authentication icon Xpra-Light.zip authentication icon

The Light builds have more limited codec support and do not include any of the server components, which is why those builds use a lot less disk space.

The beta builds can be found here: https://xpra.org/beta/windows/

You can also install xpra using MSYS2 by running pacman -S mingw-w64-x86_64-python3-xpra. The only downside of using this method is the lack of file association, but you do get more control over which components and dependencies are and aren't installed.

MacOS MacOS

The Mac OSX downloads directory contains:

Format Purpose Download Link GPG Signature
x86_64 DMG Disk Image Xpra.dmg authentication icon
x86_64 PKG PKG Installer Xpra.pkg authentication icon
arm64 DMG Disk Image Xpra.dmg authentication icon
arm64 PKG PKG Installer Xpra.pkg authentication icon

These MacOS packages are not notarized, please see Can't you just right click? for installation.

If MacOS complains that the application is damaged, run: sudo xattr -rd com.apple.quarantine /Applications/Xpra.app

The beta MacOS builds can be found here: https://xpra.org/beta/MacOS

Linux Linux

The Linux stable repositories are all found here: https://xpra.org/dists/
The beta repositories are here: https://xpra.org/beta/
Note: the beta repositories are supplemental ones so you must also enable the stable repository to be able to use them.

Sub-packages

Installing xpra using your package manager should install the client and server components as well as most picture codecs and audio support.
For slimmer installations, you may also want to use apt's --no-install-recommends or dnf's --setopt=install_weak_deps=False and select individual xpra sub-packages:

Package Details
xpra-filesystem this package contains configuration files and is independent of the python version
See multiple python targets (version 6 onwards)
xpra-common this package is required by all the other sub-packages
xpra-client console clients: xpra stop, xpra info, etc
xpra-client-gtk3 the main client GUI for connecting to sessions: xpra attach, xpra launcher, etc
xpra-server for starting sessions locally: xpra start, xpra desktop, xpra shadow, etc
xpra-x11 required for all X11 server session types (ie: xpra start and xpra desktop) and for X11 clients
xpra-audio audio forwarding support for both client and server
xpra-codecs core picture compression codecs
xpra-codecs-extras more video compression codecs with heavier footprint and / or licensing requirements
xpra-codecs-nvidia extra proprietary NVidia codecs: nvenc, nvjpeg, nvdec, nvfbc, etc

RPM for RPM distributions:

  • download the chosen repository file (stable or beta) into /etc/yum.repos.d as root, ie: for Fedora:
wget -O /etc/yum.repos.d/xpra.repo https://xpra.org/repos/Fedora/xpra.repo
  • dnf install xpra
Distribution Stable Repository file Beta Repository File Extra Notes
Fedora xpra.repo xpra-beta.repo
AlmaLinux xpra.repo xpra-beta.repo enable crb and EPEL
RockyLinux xpra.repo xpra-beta.repo enable crb and EPEL
RedHat Enterprise Linux use AlmaLinux repository use AlmaLinux repository
CentOS use AlmaLinux repository use AlmaLinux repository
CentOS Stream xpra.repo xpra-beta.repo
OracleLinux xpra.repo xpra-beta.repo

Starting with version 5, the RPM packages depend rpmfusion packages for some codecs, RHEL and clones also depend on EPEL packages.
To enable crb: dnf config-manager --set-enabled crb
Should you wish to do so, you can also build your own packages.

Debian for Debian based distributions:

  • ensure the SSL certificates are up to date: sudo apt install ca-certificates
  • import the key used for signing the packages (newer Debian releases require a newer key, a newer sources format, etc): 
    sudo wget -O "/usr/share/keyrings/xpra.asc" https://xpra.org/xpra.asc
    (if the file already exists, you may hit some problems )
  • download the appropriate repository file (see table below) into /etc/apt/sources.list.d as root:
    cd /etc/apt/sources.list.d ; wget $REPOFILE
  • then run apt update ; apt install xpra
Distribution Stable Repository file Beta Repository File
Debian Bullseye xpra.sources xpra-beta.sources
Debian Bookworm xpra.sources xpra-beta.sources
Debian Trixie (*) use beta only until ABI is stable xpra-beta.sources
Debian Sid (*) use beta only xpra-beta.sources
Ubuntu Bionic Beaver (*) xpra.sources xpra-beta.sources
Ubuntu Focal Fossa xpra.sources xpra-beta.sources
Ubuntu Jammy Jellyfish xpra.sources xpra-beta.sources
Ubuntu Mantic Minotaur xpra.sources xpra-beta.sources
Ubuntu Noble Nombat use beta only until ABI is stable xpra-beta.sources

The DEB repositories may require the "universe" repository source to be activated to get all the features.
(*) Distributions that do not provide a stable ABI should enable the beta repository.
(*) Older distributions can only run xpra 3.1.x and not later versions.

Step by step example for installing the stable repository on Ubuntu Jammy Jellyfish

Execute these commands as root (ie: using `sudo):

DISTRO=jammy
#install https support for apt (which may be installed already):
apt update
apt install apt-transport-https software-properties-common
apt install ca-certificates
# add xpra GPG key:
wget -O "/usr/share/keyrings/xpra.asc" https://xpra.org/xpra.asc
# add the xpra repository:
wget -O "/etc/apt/sources.list.d/xpra.sources" https://xpra.org/repos/$DISTRO/xpra.sources
# add the optional beta channel:
# wget -O "/etc/apt/sources.list.d/xpra-beta.sources" https://xpra.org/repos/$DISTRO/xpra-beta.sources
# install the xpra package:
apt update
apt install xpra

For other distributions, simply change DISTRO to match your distribution name.

Older distributions may also need to use the deprecated .list files from here and the following keys:

sudo wget -O "/usr/share/keyrings/xpra-2018.gpg" https://xpra.org/xpra-2018.gpg
sudo wget -O "/usr/share/keyrings/xpra-2022.gpg" https://xpra.org/xpra-2022.gpg
Clone this wiki locally