Skip to content

Reporting Bugs

Jump to bottom
Antoine Martin edited this page Aug 2, 2026 · 5 revisions

Reporting Bugs

A focused checklist for creating reports that can be reproduced and fixed quickly.

Before opening an issue

Use the built-in bug reporting tool from the system tray, press Alt+Shift+F3, or run:

xpra bug-report

On Microsoft Windows, you can also launch Bug_Report.exe.

Whenever possible, include a minimal reproducible example. The advice in How to Ask Questions the Smart Way is also useful when describing technical problems.

What to include

Environment

  • Full operating-system details for both client and server.
  • Full Xpra version and how it was installed.
  • Desktop environment and window manager, when applicable.
  • Non-standard details such as multiple screens, unusual resolutions, virtualization, or access through VNC or RDP.
  • Network type and bandwidth constraints—for example, local, LAN, or DSL.
  • Relevant environment variables, such as %PATH% on Windows or $PATH and $LD_LIBRARY_PATH on Linux.

Reproduction

  • Full command lines used on both client and server.
  • Exact steps needed to reproduce the problem and whether it happens reliably.
  • Whether this is a regression and, if so, when it started.
  • Whether related or similar issues already exist.
  • Whether it affects every picture encoding.
  • Whether disabling audio, OpenGL, clipboard, or other features changes it.
  • Whether reconnecting or using a different client or operating system helps.
  • Any other unusual behavior observed at the same time.

Diagnostics

  • Changes from the default configuration, as shown by xpra showconfig.
  • xpra info output for the affected session.
  • The server log or console output when no log file is used.
  • Relevant log sections with enough surrounding context—not just the final error, and not necessarily the entire file.
  • Results from the debugging guide, when applicable.

Warning

Do not use temporary pastebin services for diagnostic data. Attach files or paste formatted excerpts directly into the issue so the report remains useful later.

Prefer exact output

Paste the commands and their results instead of using descriptions such as “the latest version,” which changes across platforms and repositories. For example:

$ rpm -qa | grep xpra
xpra-4.0.6-10.fc33.x86_64

The required information varies by subsystem. For example, keyboard issues have their own debugging guidance.

← Wiki home · Open a bug report · Debugging

Clone this wiki locally