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/xpraand the per-user settings can be placed in~/.config/xpra- you can also run thexpra/platform/paths.pyscript for more details - on Mac OS X, we ship a command line tool found under
Xpra.app/Contents/Helpers/Path_infowhich will show the file locations, the default location for user configuration files should be~/Library/Application Support/Xprayou can also use -~/.config/xpra - on MS Windows, run the
Path_info.exetool 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.