xpra icon
Bug tracker and wiki

Version 2 (modified by Antoine Martin, 7 years ago) (diff)



Sometimes the problem is so obvious that you will simply get the error directly from the command line or in the server log file.


Otherwise, a good first step is to start xpra from the command line and add "-d CATEGORY" to it. The list of categories can be found with xpra -d help. You can also prefix the CATEGORY with a dash "-" to disable debug logging for it. ie:

xpra start :10 -d all,-window

Environment Variables

Each logging category can also be enabled using environment variable, which can be useful if you cannot modify the command line, or if the logging should happen very early on, or if you aren't calling the code from its normal wrappers. Use: XPRA_CATEGORY_DEBUG=1 xpra ... to enable debug logging for your chosen CATEGORY.

Xpra control interface

It is also possible to enable and disable debug logging at runtime using:

xpra control :DISPLAY debug enable CATEGORY


xpra control :DISPLAY debug enable CATEGORY

And you can get the current list of debug loggers which:

xpra control :DISPLAY debug status

Detailed Logging

Some subsystems require special environment variables to enable logging, this is to minimize the cost of logging in performance critical paths.

For example:

  • x11 event handling:
    XPRA_X11_DEBUG_EVENTS="*" xpra start :10


XPRA_X11_DEBUG_EVENTS="EnterNotify,CreateNotify" xpra start :10
  • XShm and image debugging code:
    XPRA_XSHM_DEBUG=1 xpra start :10


XPRA_XIMAGE_DEBUG=1 xpra start :10

Please refer to the source code for details and more up to date information.