1. Home
2. Linux Knowledge Base
3. CrossOver Linux Tutorials
4. Installing CrossOver Linux

Get your 14-day, fully-functional trial from our Trial Page

If you've purchased CrossOver, download it from My Downloads

Installing CrossOver Linux

Ubuntu, Mint, and Debian ( .deb Package)
ChromeOS (.deb Packages)
Fedora and RHEL (.rpm Package)
Other Distros (.bin Pckage)

Unlocking CrossOver Linux

Standard Unlocking
Unlocking with Activation Code
Unlocking via Terminal
Unlocking with License Files

Installing the .deb Package on Ubuntu, Mint, or Debian

Graphical Install

Download the CrossOver .deb package from My Downloads. Right-click the .deb file and Open With>Gdebi.

If you don't have Gdebi, you can install CrossOver from a terminal.

Terminal Install

Open a terminal session and navigate to the directory containing the .deb package. Then install CrossOver using apt:

sudo apt install ./crossover_22.0.1-1.deb

If CrossOver is already installed on your system, following the same steps upgrades CrossOver to the newest binaries.

Installing the .deb Package on ChromeOS

1. Turn on the Linux option in ChromeOS. Open Settings and click Linux (Beta) then Turn On.
2. You will want to increase the size of the disk as the default 5GB is too small for multiple Windows applications.
3. Download the CrossOver .deb package from My Downloads.
4. Right-click the .deb file and choose Install with Linux (Beta) and then click the blue Install button.

Once the installation is done Crossover will have an icon that you use in Launcher menu.

Installing the .rpm Package on Fedora or RHEL

First, bring the system up to date:
sudo dnf update

or

sudo yum update

We recommend using the DNF package management tool to install Crossover on an rpm-based system as follows:

sudo dnf install http://crossover.codeweavers.com/redirect/crossover.rpm

If DNF is unavailable, use YUM or the RPM package management tool as follows:

sudo yum install http://crossover.codeweavers.com/redirect/crossover.rpm

sudo rpm -ivh http://crossover.codeweavers.com/redirect/crossover.rpm

For Fedora 30 users, additional packages may be required. Install the additional packages from Terminal as follows:

dnf install \
nss-mdns.i686 mesa-libGLU.i686 isdn4k-utils.i686 libgphoto2.i686 mpg123-libs.i686 openal-soft.i686 \
ocl-icd.i686 mesa-libOSMesa.i686 sane-backends-devel.i686 libxslt.i686 libnsl.i686 libnsl.x86_64 \
gstreamer1.i686 \
libxcrypt-compat

Installing the Generic Shell (.bin) Package on Linux

The generic shell (.bin) installer is universal and can be installed on most Linux systems. This installer doesn't download any needed dependency packages, so we recommend using the .deb or .rpm package when possible.

1. Open Terminal.
2. Download the latest version of CrossOver.
   wget http://crossover.codeweavers.com/redirect/crossover.bin
3. Set the .bin file to be executable.
   $ chmod +x crossover.bin
4. Run the file.
   $ ./crossover.bin

Standard Unlocking

From the CrossOver main menu, select Unlock CrossOver. Enter your codeweavers.com email address and password in the Unlock CrossOver) dialog box and click Unlock**.

Unlocking With an Activation Code

If you received an activation code to unlock CrossOver, select Unlock CrossOver from the main menu and click Enter an Activation Code. Enter your information in the Enter Activation Code dialog box and click Unlock. CrossOver then creates your codeweavers.com account (from the information you entered) and attaches the activation code to your profile. You can also attach the activation code to your account on this webpage.

In the future, if you need to unlock CrossOver, follow the standard unlocking procedures. The activation code is only needed once.

Unlocking via Terminal

To manually unlock CrossOver, open a Terminal and enter the following command:

$ sudo -H /opt/cxoffice/bin/cxregister

Unlocking with License Files

1. Go to My Orders.
2. Click Generate CrossOver Linux License.
3. Unzip the downloaded file.
4. Copy the two license.* files into /opt/cxoffice/etc.