CrossOver Support

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


Missing or broken 32-bit C library
Missing or broken libgcc_s.so.1 library
Missing or broken libpthread.so.0 library
Missing or broken libnss_mdns.so.2 library
Missing or broken libX11.so.6 library
Missing or broken libXext.so.6 library
Missing or broken libfreetype.so.6 library
Missing or broken libpng* library
Missing or broken librt.so.1 library
Missing or broken libunwind.so.8 library
Bad virtual memory limit
Cannot create 16-bit LDT segments
pthread_cancel() does not work
X11 does not work
Cxdiag failed


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 libgssapi_krb5.so.2 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 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 64-bit libunwind.so.8 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


X11 and OpenGL issues


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


Other issues


Missing Debian packaging tools
Missing RPM packaging tools


Deprecated issues


LibCrypto/LibSsl Mismatch
Missing GStreamer 1.0 Bad plugins
Missing GStreamer 1.0 Base plugins
Missing GStreamer 1.0 Good plugins
Missing libaudio 32-bit library
Missing libaudiofile 32-bit library
Missing libcrypto 32-bit library
Missing libesd 32-bit library
Missing libgstapp 32-bit library
Missing libgstreamer 32-bit library
Missing libhal.so.1 32-bit library
Missing libICE.so.6 32-bit library
Missing libjack 32-bit library
Missing libjpeg 32-bit library
Missing liblcms 32-bit library
Missing libOSMesa.so.6 32-bit library
Missing libSM.so.6 32-bit library
Missing libssl* 32-bit library
Missing libtiff.so.4 32-bit library
Missing libtxc_dxtn 32-bit library
Missing libv4l.so.0 32-bit library
Missing libxcb 32-bit library
Missing libXt 32-bit library
Missing S3TC texture support
Last modified on 2020-06-19 07:14:44 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
Please Wait...
eyJjYXJ0IjowLCJ0enMiOi01LCJjZG4iOiJodHRwczpcL1wvbWVkaWEuY29kZXdlYXZlcnMuY29tXC9wdWJcL2Nyb3Nzb3Zlclwvd2Vic2l0ZSIsImNkbnRzIjoxNTg2NDQyNzI0fQ==