Linux Installation Guide¶
Genymotion Desktop is only available for Linux 64-bit (x86_64, amd64).
Supported distributions¶
Gnome, KDE and MATE desktop environments are fully supported. Other environments may not work correctly.
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 38
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.8 .deb package for Ubuntu 22.04 and place it in the
~/Downloads
directory. -
Perform a global update and reboot:
sudo apt update && sudo apt upgrade && sudo reboot
-
Install the downloaded package:
sudo apt install ./virtualbox-7.0_7.0.8-156879~Ubuntu~jammy_amd64.deb
Press Y and press ENTER to confirm. VirtualBox 7.0.8 dependency packages are being downloaded and installed. It may take a while to complete.
-
Add your user to the vboxusers group:
sudo usermod -a -G vboxusers $USER
-
Reboot your PC.
To verify your installation, run the following commands in a terminal:
groups | grep vboxusers
If this command does not return anything, then your user account is not in the vboxusers
group. To solve this, run sudo usermod -a -G vboxusers $USER
, then log out and in again - or reboot your PC.
Next, verify that VirtualBox kernel modules are properly installed and working:
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.
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.8 .deb package for Debian 11 and place it in the
~/Downloads
directory. -
Perform a global update:
sudo apt update && sudo apt upgrade && sudo reboot
-
Install the downloaded package:
sudo apt install ./virtualbox-7.0_7.0.8-156879~Debian~bullseye_amd64.deb
Press Y and press ENTER to confirm. VirtualBox 7.0.8 dependency packages are being downloaded and installed. It may take a while to complete.
-
Add your user to the vboxusers group:
sudo usermod -a -G vboxusers $USER
-
Reboot your PC.
To verify your installation, run the following commands in a terminal:
groups | grep vboxusers
If this command does not return anything, then your user account is not in the vboxusers
group. To solve this, run sudo usermod -a -G vboxusers $USER
, then log out and in again - or reboot your PC.
Next, verify that VirtualBox kernel modules are properly installed and working:
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.
-
(optional, recommended) 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
Validate the prompt to accept the PGP key.
-
Refresh
dnf
local cache:sudo dnf update --refresh
-
Install VirtualBox and all dependencies:
sudo dnf install VirtualBox kernel-devel-$(uname -r) akmod-VirtualBox
Then:
sudo akmods && systemctl restart vboxdrv
-
Finally, add your user to the vboxusers group:
sudo usermod -a -G vboxusers $USER
-
Close your session and log in again to apply the change. To verify, use the
groups
command; you should seevboxusers
in the returned list:john@johnPC$ groups john adm cdrom sudo dip plugdev input lpadmin lxd sambashare 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.
To verify that VirtualBox kernel modules are properly installed and working, 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 issues due to access permissions.