CrossOver troubleshooting documentation

In CrossOver 15 we have streamlined our ability to help us help you. If you are having trouble and want to contact us or troubleshoot your system yourself, please start by launching CrossOver. Then, click on the Help menu option and choose System Information. This will immediately report the information CrossOver sees about your system including issues detected by our diagnostic tool. That will make choosing the correct pages easier.

If you still cannot resolve the trouble you're seeing, please include your System Report when you Contact Us.

Using cxfix or cxdiag

Starting with CrossOver 17, cxfix can detect and fix the most common issues. To use it open a terminal, change to the CrossOver binary directory (either /opt/cxoffice or ~/cxoffice), and run:

/cxfix --auto

This should install all the libraries most likely to be needed by Windows applications. Furthermore, for any issue that it cannot solve, cxfix will point you to the relevant page in the list below.

Alternatively you can also run cxdiag, CrossOver's diagnostic tool, to check your Linux computer for missing libraries and other potential problems. You would start it in the same way as cxfix but run the following commands instead:

./bin/cxdiag
./bin/cxdiag64

Each issue has a title which should help you identify the relevant page below.

Critical issues

Cxdiag failed

Missing or broken C library
Missing or broken libfreetype.so.6 library
Missing or broken libgcc_s.so.1 library
Missing or broken libnss_mdns.so.2 library
Missing or broken libpng library
Missing or broken libpthread.so.0 library
Missing or broken librt.so.1 library
Missing or broken libunwind.so.8 library
Missing or broken libX11.so.6 library
Missing or broken libXext.so.6 library

Bad virtual memory limit
Cannot create 16-bit LDT segments
pthread_cancel() does not work
X11 does not work

Issues impacting the CrossOver GUI

Missing Debian packaging tools
Missing File::Copy Perl module
Missing gzip tool
Missing OpenSSL tool
Missing Python 3 D-Bus support
Missing Python 3 GObject introspection support
Missing Python 3 GTK 3 support
Missing Python VTE 2.91 support
Missing RPM packaging tools

Missing libraries

Other issues : broken audio, X11, OpenGL, etc.

ALSA does not go through PulseAudio
Low X11 Screen Depth
OpenGL cannot support Direct3D 10
OpenGL does not work
OpenGL is not using Direct Rendering
Outdated AMD OpenGL Driver
Outdated NVIDIA OpenGL Driver
Missing floating point texture support
GLSL version check failed

Deprecated issues

Last modified on 2022-04-01 16:39:18 by CJ Silver

Are you sure you want to delete this page?
Note: Any nested pages that are under this one will be moved up one level. Any attachments tied to this page will be deleted.

Move / Rename Page

Enter the new path of this page:

Unknown Error, unable to move!

That page exists already!

One or more of the parent pages specified in new path do not exist!

/support/wiki/ /support/wiki/diag