Skip to content

Linux Installation Guide

Warning

  • Genymotion Desktop cannot run in a Linux virtual machine or hypervisor.
  • Server systems are not supported.
  • Genymotion Desktop is only available for Linux 64-bit (x86_64, amd64).
  • Gnome, KDE and MATE desktop environments are fully supported. Other environments may not work correctly.

Supported distributions

Due to the high number and variety of Linux distributions, it is impossible for us to test Genymotion Desktop on each and every one of them. For this reason, only the following distributions are officially supported:

  • Ubuntu 22.04LTS (Jammy Jellyfish)
  • Debian 11 (Bullseye)
  • Fedora Workstation 36

Hypervisor

3.3.0

Genymotion Desktop requires an hypervisor to run the Android system. From Genymotion Desktop 3.3.0 onwards, it is possible to choose between QEMU or VirtualBox.

QEMU is included with Genymotion. It requires kvm which is installed by default on our supported distributions.

You should not need to install anything if you choose this hypervisor.

VirtualBox is not included in our installer and needs to be installed prior to Genymotion Desktop:

Secure Boot

If Secure Boot is enabled on your host machine, VirtualBox installer will try to sign its kernel modules during installation and you will need to set a password to your Secure Boot. A full reboot of your system is mandatory to apply the change after installation.

You will then be prompted at startup by Secure Boot to input the password you set.

Recommended version

We strongly recommend using VirtualBox from your distribution offical repositories. We cannot guarantee the result if you install it from PPA or Oracle repository - do it at your own risks!

Before installing VirtualBox, it is recommended to perform a global update:

sudo apt update && sudo apt upgrade && sudo reboot

Then, you just need to install the package provided by your distribution:

sudo apt install virtualbox

It is recommended to reboot your PC after installing VirtualBox.

You can verify VirtualBox installation. In a terminal, run the following command:

lsmod | grep -i vbox

If successful, it should return the following:

$ lsmod | grep -i vbox
vboxnetadp             28672  0
vboxnetflt             28672  0
vboxdrv               524288  2 vboxnetadp,vboxnetflt

If not, try to force VirtualBox kernel modules compilation:

sudo apt-get --reinstall install virtualbox-dkms

And reboot your PC.

Recommended version

The following method has been tested with success. We cannot guarantee the result if you install VirtualBox using a different method - do it at your own risks!

Note

It is assumed that your user account is a member of group sudo. If not, you will have to run the following commands as root.

Before installing VirtualBox, it is recommended to perform a global update and reboot:

sudo apt update && sudo apt upgrade && sudo reboot

Then, enable the bullseye-backport repository:

  1. Add the following line to sources.list:

    deb http://deb.debian.org/debian bullseye-backports main
    
  2. Update the repository index:

    sudo apt update
    

When done, add the Fast track repository:

  1. Import fasttrack archive keyring:

    sudo apt install fasttrack-archive-keyring
    
  2. Add the following lines to sources.list:

    deb https://fasttrack.debian.net/debian-fasttrack/ bullseye-fasttrack main contrib
    
    deb https://fasttrack.debian.net/debian-fasttrack/ bullseye-backports-staging main contrib
    
  3. Update the repository index:

    sudo apt update
    

Finally, install Virtualbox:

sudo apt install virtualbox
It is recommended to reboot your PC after installing VirtualBox.

You can verify VirtualBox installation. In a terminal, run the following command:

lsmod | grep -i vbox

If successful, it should return the following:

$ lsmod | grep -i vbox
vboxnetadp             28672  0
vboxnetflt             28672  0
vboxdrv               524288  2 vboxnetadp,vboxnetflt

If not, try to force VirtualBox kernel modules compilation:

sudo /sbin/vboxconfig

And reboot your PC.

Recommended version

We strongly recommend installing VirtualBox from RPM Fusion repository. We cannot guarantee the result if you install it from Oracle repository or use a different method - do it at your own risks!

Before installing VirtualBox, it is recommended to perform an OS upgrade:

sudo dnf -y upgrade && sudo reboot

Add the RPM Fusion repository:

sudo dnf install https://mirrors.rpmfusion.org/free/fedora/rpmfusion-free-release-$(rpm -E %fedora).noarch.rpm https://mirrors.rpmfusion.org/nonfree fedora/rpmfusion-nonfree-release-$(rpm -E %fedora).noarch.rpm && sudo dnf update --refresh

Validate the prompt to accept the PGP key.

Install VirtualBox and all dependencies:

dnf install VirtualBox kernel-devel-$(uname -r) akmod-VirtualBox

Then:

akmods && systemctl restart vboxdrv

Finally, add your user to the vboxusers group:

sudo usermod -a -G vboxusers $USER

To verify, use id $USER. If successful, it should return groups=976(vboxusers):

$ id $USER
groups=976(vboxusers)

If the installation fails, please refer to RPM Fusion Howto for more details and instructions.

It is recommended to reboot your PC after installing VirtualBox.

You can verify VirtualBox installation. In a terminal, run the following command:

lsmod | grep -i vbox

If successful, it should return the following:

$ lsmod | grep -i vbox
vboxnetadp             28672  0
vboxnetflt             28672  0
vboxdrv               524288  2 vboxnetadp,vboxnetflt

If not, try to force VirtualBox kernel modules compilation:

sudo /sbin/vboxconfig

And reboot your PC.

Genymotion Desktop Installation

  1. Open a terminal and move to your home Download folder1:

    cd ~/Download
    
  2. Give run permission to the Genymotion installer binary file:

    chmod +x genymotion-X.Y.Z-linux_x64.bin
    
  3. Run the installer. PATH is the install target path2:

    ./genymotion-X.Y.Z-linux_x64.bin -d PATH
    
Global installation (not recommended)

It is possible to install Genymotion globally with the sudo command:

sudo ./genymotion-X.Y.Z-linux_x64.bin

This will install Genymotion in /opt/genymotion, however we do not recommend this as it may cause bugs due to access permissions.


  1. It is assumed that downloaded files are in your home Download folder. If not, replace ~/Download with the appropriate path in the command lines. 

  2. If the installer is run without -d option, Genymotion will be installed in your current folder, in genymotion/

Back to top