xpra icon
Bug tracker and wiki

Version 4 (modified by Antoine Martin, 5 years ago) (diff)


Environment Options

This page lists some features which are often only available via environment variables, or where the environment variables override other options.

This list evolves constantly and should not be used as a definitive reference, only the source code for a particular version is.

There are also many environment variables which can be set for debugging, see wiki/Logging.

Generic Environment Variables

XDG_CURRENT_DESKTOP Detect the Ubuntu 'Unity' desktop
LD_LIBRARY_PATH Locate wiki/FakeXinerama and other libraries
DBUS_SESSION_BUS_ADDRESS Locate the dbus session server


DEFAULT_XPRA_CONF_FILENAMETo change the default from: 'xpra.conf'
DEFAULT_NET_WM_NAMETo change the default from 'Xpra' (see ticket:705#comment:10)
SOCKET_TIMEOUTHow long to wait before the initial connection times out (defaults to 10)
TCP_NODELAY Use TCP no-delay (defaults to 1)
NO_ROOT_WARNING Skip warning if running as root (defaults to 0)
INITENV_COMMAND Defaults to "xpra initenv"
XPRA_USE_PROCESS_POLLING Use process polling instead of relying on SIGCHLD XPRA_SKIP_UI Skip warnings, useful when running without a console (defaults to 0)
XPRA_PASSWORD Override the password file option
XPRA_ENCRYPTION_KEY Override the encryption key file option

Fault Injection

XPRA_PAINT_FAULT_INJECTION_RATE Numeric value: how often to simulate paint errors (a value of 10 will cause 1 fault for every 10 paint events)
XPRA_PAINT_FAULT_INJECTION_TELL Whether paint faults are reported back to the server


XPRA_DISCARD_TARGETS List of clipboard targets which are discarded
XPRA_TRANSLATEDCLIPBOARD_LOCAL_SELECTION Default local selection for translated clipboard
XPRA_TRANSLATEDCLIPBOARD_REMOTE_SELECTION Default remote selection for translated clipboard