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.

QEMUVirtualBox

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.

Ubuntu 22.04LTS Debian 11 Fedora Workstation 36

Download VirtualBox 7.0.4 .deb package for Ubuntu 22.04 with this link and place it in the ~/Downloads directory.

Perform a global update:

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

Install the downloaded package:
```
$ cd ~/Downloads
~/Downloads$ sudo apt install ./virtualbox-7.0_7.0.4-154605~Ubuntu~jammy_amd64.deb
```
Press Y and press ENTER to confirm. VirtualBox 7.0.4 dependency packages are being downloaded and installed. It may take a while to complete.
It is recommended to reboot your PC at this point.

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 vboxconfig

And reboot your PC.

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.

Download VirtualBox 7.0.4 .deb package for Debian 11 with this link and place it in the ~/Downloads directory.

Perform a global update:

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

Install the downloaded package:
```
$ cd ~/Downloads
~/Downloads$ sudo apt install ./virtualbox-7.0_7.0.4-154605~Debian~bullseye_amd64.deb
```
Press Y and press ENTER to confirm. VirtualBox 7.0.4 dependency packages are being downloaded and installed. It may take a while to complete.
It is recommended to reboot your PC at this point.

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 vboxconfig

And reboot your PC.

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¶

Open a terminal and move to your home Download folder¹:
```
cd ~/Download
```
Give run permission to the Genymotion installer binary file:
```
chmod +x genymotion-X.Y.Z-linux_x64.bin
```
Run the installer. PATH is the install target path²:
```
./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.

It is assumed that downloaded files are in your home Download folder. If not, replace ~/Download with the appropriate path in the command lines. ↩
If the installer is run without -d option, Genymotion will be installed in your current folder, in genymotion/. ↩