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 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


Missing DRI drivers
Missing GStreamer 1.0 Bad plugins
Missing GStreamer 1.0 Base plugins
Missing GStreamer 1.0 Good plugins
Missing GStreamer 1.0 Libav plugins
Missing GStreamer 1.0 Ugly plugins
Missing GStreamer 1.0 Ugly plugins (mpg123audiodec)
Missing or broken libasound.so.2 library
Missing or broken libasound.so.2 library for MIDI support
Missing or broken libcapi20.so.3 library
Missing or broken libcrypt.so.1 library
Missing or broken libcups.so.2 library
Missing or broken libdbus-1.so.3 library
Missing or broken libfontconfig.so.1 library
Missing or broken libGL.so.1 library
Missing or broken libGLU.so.1 library
Missing or broken libgnutls library
Missing or broken libgphoto2.so.6 library
Missing or broken libgphoto2_port.so.10 library
Missing or broken libgsm.so.1 library
Missing or broken libgssapi_krb5.so.2 library
Missing or broken libgstreamer-1.0.so.0 library
Missing or broken libkrb5.so.3 library
Missing or broken liblber-2.4.so.2 library
Missing or broken liblcms2.so.2 library
Missing or broken libldap_r-2.4.so.2 library
Missing or broken libmpg123.so.0 library
Missing or broken libncurses.so.5 library
Missing or broken libnsl.so.1 library
Missing or broken libodbc.so.2 library
Missing or broken libopenal.so.1 library
Missing or broken libOpenCL.so.1 library
Missing or broken libOSMesa.so.8 library
Missing or broken libpcap.so.0.8 library
Missing or broken libpulse.so.0 library
Missing or broken libresolv.so.2 library
Missing or broken libsane.so.1 library
Missing or broken libstdc++.so.6 library
Missing or broken libtiff.so.5 library
Missing or broken libudev.so.1 library
Missing or broken libusb-1.0.so.0 library
Missing or broken libv4l2.so.0 library
Missing or broken libvulkan.so.1 library
Missing or broken libXcomposite.so.1 library
Missing or broken libXcursor.so.1 library
Missing or broken libXfixes.so.3 library
Missing or broken libXi.so.6 library
Missing or broken libXinerama.so.1 library
Missing or broken libxml2.so.2 library
Missing or broken libXrandr.so.2 library
Missing or broken libXrender.so.1 library
Missing or broken libxslt.so.1 library
Missing or broken libXxf86vm.so.1 library
Missing or broken libz.so.1 library


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


LibCrypto/LibSsl Mismatch
Missing GStreamer 1.0 Bad plugins
Missing GStreamer 1.0 Base plugins
Missing GStreamer 1.0 Good plugins
Missing or broken libaudio.so.2 library
Missing or broken libaudiofile.so.0 library
Missing or broken libcrypto library
Missing or broken libesd.so.0 library
Missing or broken libgstapp-0.10.so.0 library
Missing or broken libgstreamer-0.10.so.0 library
Missing or broken libhal.so.1 library
Missing or broken libICE.so.6 library
Missing or broken libjack.so.0 library
Missing or broken libjpeg library
Missing or broken liblcms.so.1 library
Missing or broken libOSMesa.so.6 library
Missing or broken libSM.so.6 library
Missing or broken libssl library
Missing or broken libtiff.so.4 library
Missing or broken libtxc_dxtn library
Missing or broken libv4l.so.0 library
Missing or broken libxcb.so.1.1.0 library
Missing or broken libXt.so.6 library
Missing Python 2 D-Bus support
Missing Python 2 GTK 2 support
Missing S3TC texture support
Last modified on 2020-10-21 07:59:05 by François Gouget
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
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
CodeWeavers or its third-party tools process personal data (e.g. browsing data or IP addresses) and use cookies or other identifiers, which are necessary for its functioning and required to achieve the purposes illustrated in our Privacy Policy. You accept the use of cookies or other identifiers by clicking the Acknowledge button.
Please Wait...
eyJjb3VudHJ5IjoiVVMiLCJsYW5nIjpudWxsLCJjYXJ0IjowLCJ0enMiOi01LCJjZG4iOiJodHRwczpcL1wvbWVkaWEuY29kZXdlYXZlcnMuY29tXC9wdWJcL2Nyb3Nzb3Zlclwvd2Vic2l0ZSIsImNkbnRzIjoxNjI2MjkzOTE3LCJjc3JmX3Rva2VuIjoiS1JRQVNtZFJzNFJyeUFjSiIsImdkcHIiOjB9