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

HOME	User UUID
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

Internal

DEFAULT_XPRA_CONF_FILENAME	To change the default from: 'xpra.conf'
DEFAULT_NET_WM_NAME	To change the default from 'Xpra' (see ticket:705#comment:10)
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_FORCE_COLOR_LOG	Force enable the coloured logger (defaults to 0)

X11

XPRA_X11_PROPERTIES_IGNORED	X11 properties we ignore as a CSV list, defaults to "_NET_WM_OPAQUE_REGION"
XPRA_FORCE_REPLACE_WM	Force an existing window manager to exit (defaults to 0)
XPRA_LOG_MANAGE_FAILURES	Log all failures to manage a window (defaults to 0)
XPRA_NO_NET_SUPPORTED	CSV list of "_NET_SUPPORTED" items to remove from the default list we claim to support (default is empty)
XPRA_X11_DEBUG_EVENTS	CSV list of X11 events to debug (default is empty, typical values: "KeyPress?,ClientMessage?" ..)

Network / Connection

XPRA_SOCKET_HOSTNAME	The name to use for the sockets, defaults to the hostname
SOCKET_TIMEOUT	How long to wait before the initial connection times out (defaults to 10)
TCP_NODELAY	Use TCP no-delay (defaults to 1)
XPRA_PASSWORD	Override the password file option
XPRA_ENCRYPTION_KEY	Override the encryption key file option
XPRA_XSHM	Enable XShm (default to 1)

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

Clipboard

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