Xpra Configuration

August 8, 2026 ยท View on GitHub

The most common configuration options are available directly from the main GUI tool.
Simply run xpra and click on the Configure button, or run the subcommand: xpra configure.


Most other important xpra settings can be configured from the command line or through xpra's configuration files.

You can find some example configuration files here: template /etc/xpra/ directory

The configuration files use the exact same format as the command line options, which can be shown using xpra --help, just without the -- prefix.
The manual is also shipped with all binary installations and should be easily accessible. (ie: man xpra)

(some more obscure features can be configured using environment variables)


Starting with version 6.3, settings can be changed permanently from the command line:

xpra set dpi 120

To erase this setting:

xpra unset dpi

The exact location of the configuration files varies widely from platform to platform, and even from one version of the OS to another.

  • for unix-like operating systems, the system configuration files can usually be found in /etc/xpra and the per-user settings can be placed in ~/.config/xpra - you can also run the xpra/platform/paths.py script for more details
  • on Mac OS X, we ship a command line tool found under Xpra.app/Contents/Helpers/Path_info which will show the file locations, the default location for user configuration files should be ~/Library/Application Support/Xpra you can also use - ~/.config/xpra
  • on MS Windows, run the Path_info.exe tool found in the Xpra installation folder

You should generally not edit the system default configuration files, as those may be overwritten whenever xpra is (re)installed. Use the per-user configuration files instead, or add your own configuration file.