xpra icon
Bug tracker and wiki

This bug tracker and wiki are being discontinued
please use https://github.com/Xpra-org/xpra instead.

Getting Started : Configuration


Almost all xpra features can be configured from the command line or through xpra's configuration files.

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

The configuration files use the exact same format as the command line options, which documented in the manual page, 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)

Split Configuration: conf.d

The configuration file is split into multiple files stored in a conf.d sub-directory.

This applies to the system defaults as well as the per-user configuration overrides. The main "xpra.conf" file is retained for backwards compatibility but should now usually be empty.

Configuration Files Location

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 ~/.xpra - you can also run the xpra/platform/path.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 you the file locations, the default location for user configuration files should be ~/Library/Application Support/Xpra you can also use - ~/.xpra, although this is deprecated
  • on MS Windows, you can 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.

Last modified 4 years ago Last modified on 01/31/18 04:31:54