Warnings and Official Support
- Only Ubuntu LTS, Debian Stable and Fedora Workstation distributions are officially supported.
- GNOME, KDE and MATE desktop environments are fully supported.
- Genymotion Desktop may not work correctly, or at all, with other desktop environments.
- Genymotion Desktop is currently available for x86_64 / amd64.
- Genymotion Desktop requires a hypervisor to run the Android system.
- If upgrading from a previous version, you can refresh to update available Android images.
- Genymotion Desktop works as-is with an embedded QEMU hypervisor using KVM; there is no need to install any extra software.
- VirtualBox support exists as a legacy option.
Hypervisor and Architecture Notes
- The Linux installation experience supports two options: QEMU (default) and VirtualBox (legacy).
- The QEMU option uses an embedded hypervisor; no external hypervisor installation is required.
- The VirtualBox option requires VirtualBox to be installed separately if chosen.
Linux Installation Overview
- Genymotion Desktop requires an hypervisor to run the Android system.
- If you choose QEMU (default), Genymotion Desktop uses an embedded QEMU hypervisor with KVM.
Install Genymotion Desktop on Linux
- To install Genymotion Desktop on Linux, follow these steps:
1) Open a terminal.
2) Move to the Download folder. Run the command: cd ~/Download
3) Make the installer executable. Run the command: chmod +x genymotion-X.Y.Z-linux_x64.run
4) Run the installer. Run the command: ./genymotion-X.Y.Z-linux_x64.run -d PATH
- Global installation (not recommended).
Quickstart Guide
- To start using Genymotion Desktop and run your Android application in a virtual device, follow the steps below.
Sign in
- Launch Genymotion Desktop.
- The launches are available for Windows, macOS, and Linux.
- Click from the Application menu or desktop.
- At first start, Genymotion Desktop will require you to log in.
- The login screen shows Welcome to Genymotion.
- Choose one of the following options:
- I have a license
- I use Genymotion SaaS
- Personal use
- Read the Terms & Conditions carefully and check I understand and agree to the Terms & Conditions.
- Follow the on-screen prompts to continue (NEXT).
- After initial setup, you can launch a device.
Create and configure a device
- Click to create a new device.
- Install virtual device: Genymotion Phone and related components appear.
- The device appears under a dashboard with a list of available Android images.
- From there, navigate the tabs to configure your new device:
- Summary: You can view and change the name of your device, the Android image and Hardware profile in this section.
- Android image: This is where you select the Android image to use with your device.
- Hardware profile: In this section, you can choose the hardware profile for your device.
- System: In this section, you can configure various settings for the device.
- Display: In this section, you can set various settings to control the device display.
- Primary display: Set your device resolution and dpi. You can use predefined settings, or set a custom resolution.
- Advanced display options: Select Normal for a standard device, or Multi-Display if you wish to emulate a device with multiple displays.
- Options: Set rounded corner radius and content padding to simulate a real device display with rounded corners.
- Window style: Run the device in a window (default), in full-screen, or with a skin.
- Advanced: Force the OpenGL ES maximum API version (default is 3.1).
- The Multi-Display feature is still experimental.
- Hypervisor options: QEMU (default) vs VirtualBox.
- If you upgrade from a previous version, you can click Refresh to force an update of the available Android images.
- Install virtual device: The device installation wizard presents a summary screen with Android image, hardware profile, and system details.
- To deploy a device, click Install.
- After installation, click Back to return to the device list.
- Launch a device: Click the device tile to start the device.
- After launching, you can view and configure the device via the dashboard.
- If the virtual device deployment fails, check available disk space and retry.
- Launch a device: Click the device tile to start it.
- When the device is running, Genymotion Desktop displays the Android emulator window with the configured device.
- Quick boot: A warning note may appear indicating that quick boot can cause boot and stability issues. Disable if unsure.
- Additional notes: If the virtual device deployment fails, ensure sufficient disk space and consult the troubleshooting sections.
Quickstart Device Visualization
- A Genymotion device dashboard shows the installed device with its Android image, hardware profile, and status.