Skip to content

Basic steps

To start using Genymotion Desktop and run your Android application in a virtual device, follow the steps below.

First run

  1. Launch Genymotion Desktop:

    Click Genymotion icon from Windows Application menu or desktop.

    Click Genymotion icon from the Applications directory.

    Click Genymotion icon Genymotion from your distribution Application Launcher, or in a terminal:

    $ ~/genymotion/genymotion

    If you installed Genymotion in a specific directory, replace ~/genymotion/ by your Genymotion installation path; or, if you installed it globally (with sudo), replace ~/genymotion/ by /opt/.

    Genymotion main window First start Window

  2. If you already have a Genymotion account, enter your credentials and click NEXT. Otherwise, click on CREATE ACCOUNT to create a new Genymotion account.

    If your host machine network is connected to a proxy, click View proxy options and set your Proxy type, hostname, port and authentication.

  3. In the Usage panel, select:

    • Personal use if you wish to use Genymotion Desktop free edition for personal use only.
    • I have a license if your are using Genymotion Desktop for professional use or tuition. You must own a license in that case.


  4. Read the End User License Agreement carefully and check I have read and accept the end user license agreement:


Click NEXT:


Genymotion Launcher Dashboard

Select a hypervisor


From Genymotion Desktop 3.3.0 onwards, it is possible to choose between VirtualBox or QEMU hypervisor.

The default hypervisor is QEMU. But if you upgraded from a previous Genymotion Desktop version, it will be VirtualBox.

  1. Go to Genymotion > Settings > Hypervisor
  2. Select QEMU or VirtualBox from the drop-down box:


If you change from the default, you will be prompted to restart Genymotion to apply that change. For more information, please refer to Genymotion configuration.

Each created virtual device depends on the hypervisor. For example, Virtual devices created with VirtualBox will disappear from Genymotion dashboard if the hypervisor is switched to QEMU, and vice versa.

Create a new device

  1. Click on Add a device and select a virtual device template from the list. You can use the search box and Filters to find a specific device profile:

    Virtual device installation

  2. Click on NEXT or double-click on the template of your choice. The virtual device installation wizard opens:

    Install virtual device wizard
    Virtual device installation Wizard

    If you upgraded from a previous version, you can click to force an update of the available Android images.

  3. In the GENERAL tab, you can change the name and select the Android version of the device:

    Select Android version
    Click NEXT when done

  4. In the SYSTEM tab, you can change the number of processors, RAM and/or VM Heap size:

    Click NEXT to proceed

  5. In the DISPLAY tab, you can select the resolution, the window style and the OpenGL ES maximum API version:

    Device tab
    Click NEXT to proceed

  6. In the Android options tab, you can enable or disable the Android navigation bar (default: enabled) and the virtual keyboard (default: disabled):

    Android opt tab
    Click NEXT to proceed

In the Hypervisor options tab, you can toggle QEMU quick boot feature:

Hypervisor opt tab
Click INSTALL to start the device deployment

In the Hypervisor options tab, you can set the NAT (default) or Bridge hypervisor network mode:

Hypervisor opt tab
Click INSTALL to start the device deployment

Your virtual device is being downloaded and will appear in the dashboard:

Launcher dashboard

Genymotion Desktop launcher dashboard

If the virtual device deployment fails at this point, you may be running out of free space.

Launch a device

Double click on your newly created virtual device, or click , to start it:

Virtual device main window

Virtual Device display

If you wish to change Genymotion or the device configuration, please refer to the following pages:

Back to top