# Get Started

In this section, you will get all the information you need to start using Genymotion Desktop in terms of requirements, installation and license. You will also be guided through the very first actions to quickly have a virtual device ready to run an application.

# Requirements

# Desktop account

In order to download and use Genymotion Desktop, you first need to create a Genymotion account:

  1. Create an account here (opens new window)
  2. An email will be sent to you, click on the validation link to activate your account.
  3. Sign in (opens new window) with your credentials.

# Hardware

Important

  • The minimal hardware requirements can only run Android 4.4 to 6.0 with low performance.
  • SSSE3 (opens new window) capability is mandatory to run Android 7.0 and higher.
Component Recommended Minimal
CPU
  • Dual-core 64bit CPU
  • VT-x or AMD-V/SMV capability
Graphics OpenGL 3.0 or higher capable video card.

We recommend the use of one of the following minimum graphic chips:
  • Intel HD Graphics 4000 (2012)
  • Nvidia GeForce 500 Series (2011)
  • AMD Radeon HD 6000 Series (2011)
OpenGL 2.0 capable video card.
RAM Memory 8GB or higher 4GB
Screen resolution 1600 x 900 or higher 1280 x 768
Free HD space
  • 120MB for Genymotion Desktop
  • 1GB per virtual devices
  • 120MB for Genymotion Desktop
  • 1GB per virtual devices

# Operating Systems

Virtual Machines and servers

Running Genymotion Desktop in a virtual machine (VirtualBox, VMWare, Parallels, Hyper-V or VirtualPC) or a server is not supported. For more details, please refer to the following articles:

Genymotion Desktop is compatible with the following operating systems:

Operating System Supported versions/distributions
Microsoft Windows Windows 7 and Windows Server editions are not supported.
  • Windows 10 (64 bit)
  • Windows 8/8.1 (64 bit)
Apple macOS Macs with Apple Silicon CPUs, such as the new Mac M1 series, are not supported yet.

For more information, please refer to our FAQ (opens new window)
  • macOS 11 (Big Sur)
  • macOS 10.15 (Catalina)
  • macOS 10.14 (Mojave)
  • macOS 10.13 (High Sierra)
Linux
  • Ubuntu 20.04.1LTS (Focal Fossa) (64 bit)
  • Debian 9 (Stretch) (64 bit)
  • Fedora 30 (64 bit) or above
Other distributions are not officially supported.

# Prerequisite

Important

We cannot guarantee Genymotion Desktop operations, nor provide technical assistance, if you use a non-recommended VirtualBox version.

Genymotion Desktop requires Oracle VM VirtualBox to run. Download the recommended version for your operating system:

Operating System VirtualBox recommended version
Windows VirtualBox 6.1.14 for Windows hosts (opens new window).

You do not need to install VirtualBox if you downloaded our Windows installation pack with VirtualBox included.
macOS VirtualBox 6.1.16 for macOS hosts (opens new window)
Linux Our recommended distributions (see Operating Systems) all offer a VirtualBox package which has been tested. If you are using a different distribution, it may not work "out of the box".

Please make sure that your distribution package provides VirtualBox v6.1.10 or above.

# Installation

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

# Basic steps

# First start

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

  1. Launch Genymotion Desktop.

    Windows

    Click Genymotion icon from your application menu or desktop.

    macOS

    Click Genymotion icon from the Applications directory.

    Linux

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

    # Replace {Genymotion_install_path} by your Genymotion install path.
    $ {Genymotion_install_path}/genymotion
    

    The main window opens:

    Genymotion main window

  2. Enter your account credentials and click NEXT or click on CREATE ACCOUNT to create a new Genymotion account.

  3. 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 model: Virtual device isntallation

  4. Click on NEXT or double-click on the template of your choice.

  5. Enter a name and adjust the settings, if necessary, for your new virtual device and click INSTALL: Install virtual device window

    Your virtual device is being downloaded and will appear in the My installed devices section:
    Deployment window

    Note

    If you cannot add a virtual device at this step, you may be running out of free space. We recommend you check the free remaining space on your hard disk.

  6. Double click on your newly created virtual device or click on virtual device options and select Start to start it. The virtual device window opens:

    Virtual device main window

For more information about sensor and feature emulation as well as interaction with a virtual device, please refer to Virtual Devices and Emulated sensors and features.

# Custom virtual devices

If you can't find a template for the device you wish to emulate, you can create your own custom virtual device:

  1. When adding a new device, select either the Custom Phone or Custom Tablet from the list: Custom devices The device setup window opens: Install virtual device window
  2. Set a name for the device.
  3. Choose a predefined or custom display resolution that matches the device you wish to emulate.
  4. Set your System settings (Android version, number of CPU and RAM size) to match those of the device you wish to emulate.
  5. Adjust the other options to your liking and needs.
  6. Click on INSTALL and wait for the virtual device to be deployed.

Your newly created device should appear in the My installed devices section:

Custom device

# Install applications

Please refer to Deploy an Application

# License

# Registering a license key

To register your license key, you must have a valid Genymotion Desktop account. Please refer to Requirements - Desktop account for details.

Important

Genymotion Desktop automatically connects to your user account to check the validity of the license key. If you are using Genymotion Desktop offline, you need to connect it to the Internet after 15 days. This ensures nobody else uses your license.

# Managing licenses

Once your license(s) is validated, you can refer to your user settings on the Genymotion website to view its details at any time.

To manage your license(s):

  1. Sign in to the Genymotion website (opens new window).
  2. If you are already Signed in, click on Gravatar.
  3. Click Orders.
    • In Current License, you can see the license key associated with your account, as well as its validity period. In this section, you can download Genymotion by clicking Download Genymotion.
    • In Other Licenses, you can see all licenses already purchased, their validity period as well as their related user accounts and e-mails. In this section, you can renew these licenses by clicking Extend License.

Note

If you wish to renew licenses and add some new ones at the same time, you must make two separate transactions.

# Using a license server

Note

This section is intended to users whose company has subscribed to a license server.

This section explains how you can retrieve a license from the license server in order to use Genymotion within your company's network.

Note

Depending on your network configuration, you may need to add a port number, eg: my_company_license_server.com:8888. The default port is 443 as HTTPS protocol is used.

This allocates you a license:

license server options

Then, you can use the following options:

  • EDIT: Change the license server IP/URL.
  • RENEW: Renew an offline license.
  • RELEASE: Release an offline license to make it available for other users. This also closes Genymotion.
  • REQUEST: Request a temporary offline license. Select an offline period from the drop-down list.