# 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

# 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.

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.

# Pre-requisites

Important

Genymobile cannot guarantee Genymotion Desktop operations, nor provide support, 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. Start Genymotion Desktop in one of the following ways depending on your operating system:

    Operating System Instructions
    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 run $HOME/genymotion/genymotion or opt/genymotion/genymotion in a terminal.

    The main window opens:

    Genymotion main window

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

  3. Click on Add a device, select a virtual device from the list and click on NEXT or double-click on it.

    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.

    A new window opens:
    Install virtual device window

  4. Enter a name and/or adjust the settings for your new virtual device and click INSTALL.
    Your virtual device is being downloaded and will appear in My installed devices section:
    Deployment window

  5. 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 section Virtual Devices and Emulated sensors and features.

# Custom virtual devices

If the virtual device you need to deploy is not listed in the available virtual devices list, 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
  2. The custom device setup window opens
  3. Set a name for the device
  4. Choose a predefined or custom display resolution that matches the device you wish to emulate
  5. Set your System settings (Android version, number of CPU and RAM size) to match those of the device you wish to emulate.
  6. Adjust the other options to your liking and needs
  7. Click on INSTALL and wait for the virtual device to be deployed

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

# 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:

Button Name Action
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.