Genymotion documentation

# Installation

Genymotion Desktop relies on the use of Oracle VM VirtualBox in the background to virtualize Android operating systems. If you do not already have Oracle VM VirtualBox installed, you will be asked to do so prior to installing Genymotion.

WARNING

If you already have Oracle VM VirtualBox, make sure you have the version recommended for your operating system, as detailed in section Requirements/Software.

To install Genymotion, follow the steps corresponding to your operating system.

# Windows

  1. Go to the Genymotion download page. From this page, you can:

    • download the ready-to-run Genymotion installer for Windows (recommended, 64bit only).
      This package includes Oracle VM VirtualBox installer.

    • download the Windows 32/64-bit package.
      In this case, you must first download and install VirtualBox for Windows hosts from the Download VirtualBox page.

      WARNING

      Since VirtualBox 6.0, Oracle has stopped providing support for 32bit Windows. If you use Windows 7,8 or 10 32bit, you have to use VirtualBox 5.2.32 from here

      WARNING

      When installing VirtualBox, in the Custom setup window, make sure VirtualBox Networking is enabled.

  2. Save and run the .exe file.

  3. Select the setup language and click OK. By default, the Genymotion language corresponds to your system language. The Genymotion setup wizard opens. Click Next.

  4. Select the destination folder by clicking Browse. The default destination folder is C:\Program Files\Genymobile\Genymotion. Then click Next.

  5. Select the start menu folder by clicking Browse or check Don't create a Start menu folder and click Next.

  6. Select whether or not to create a desktop icon and click Next.

  7. Click Install and Finish.

# macOS

  1. Download and install VirtualBox for OS X hosts from the Download VirtualBox page.

    WARNING

    When installing VirtualBox, in the Custom setup window, make sure VirtualBox Networking is enabled.

  2. When finished, reboot.

  3. Go to the Genymotion download page and download the macOS 64-bit package.

  4. Open the .dmg file.

  5. Drag and drop Genymotion and Genymotion Shell to the Applications directory.

# Linux

Almost every GNU/Linux system comes with an installer package for Oracle VM VirtualBox.

  1. Browse for the Oracle VM VirtualBox installer in your directories. If you do not have the installer or if you need to install a specific version, download and install VirtualBox for Linux hosts from the Download VirtualBox page.

    WARNING

    When installing VirtualBox, in the Custom setup window, make sure VirtualBox Networking is enabled.

    WARNING

    Make sure that the dkms package is installed and that it compiles VirtualBox kernel modules each time a new kernel update is available. To do so, run dmesg | grep -i vboxdrv. You should get the following (version number may differ):

    vboxdrv: Successfully loaded version 6.0.10 (interface 0x00290008)

    If not, try to force VirtualBox kernel modules compilation by running sudo /sbin/vboxconfig.

  2. Go to the Genymotion download page and download the Linux package corresponding to your system.

  3. Run the following commands:

    TIP

    We assume that downloaded files are in your home Download folder. If not, change the ~/Download to the appropriate path in the command lines below.

    cd ~/Download
chmod +x genymotion-<version>_<arch>.bin
./genymotion-<version>_<arch>.bin -d <Genymotion_install_path>

    TIP

    <Genymotion_install_path> is the path where you would like to install Genymotion binaries and libraries.

  4. Run Genymotion using the following command:

    cd <Genymotion_install_path>
./genymotion

← License →