Linux Installation Guide¶
Warning
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¶
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.
- 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 returngroups=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 folder1:
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 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.