# 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.
# Desktop account
In order to download and use Genymotion Desktop, you first need to create a Desktop account:
- Create a Desktop account here (opens new window)
- An email will be sent to you, click on the validation link to activate your account.
- Sign in (opens new window) with your credentials.
If you wish to deploy more than one virtual devices, count 1GB more per device.
# Operating Systems
Virtual environments are not supported: Genymotion Desktop will not work properly if installed and run in a VirtualBox, VMWare, Parallels, Hyper-V or VirtualPC virtual machine.
Windows & Linux 32bits
32bits Windows or Linux are 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. |
|Apple macOS||Macs with Apple Silicon CPUs, such as the new Mac M1 series, are not supported yet. |
You do not need to install VirtualBox if you downloaded our Windows installation pack with VirtualBox included.
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)|
|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.
We cannot guarantee Genymotion Desktop operations if you install a different VirtualBox version.
If you already have Oracle VM VirtualBox, make sure you have the version recommended for your operating system, as detailed in section Pre-requisites.
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:
Start Genymotion Desktop in one of the following ways depending on your operating system:
Operating System Instructions Windows Click from your application menu or desktop. macOS Click from the Applications directory. Linux Click Genymotion from your distribution Application Launcher, or run
opt/genymotion/genymotionin a terminal.
The main window opens:
Enter your account credentials and click NEXT or click on CREATE ACCOUNT to create a new account.
Click on , select a virtual device from the list and click on NEXT or double-click on it.
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:
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:
Double click on your newly created virtual device or click on and select
Startto start it. The virtual device window opens:
For more information about sensor and feature emulation as well as interaction with a virtual device, please refer to section Virtual Devices
# 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:
- When adding a new device, select either the Custom Phone or Custom Tablet from the list:
- The custom device setup window opens
- Set a name for the device
- Choose a predefined or custom display resolution that matches the device you wish to emulate
- Set your System settings (Android version, number of CPU and RAM size) to match those of the device you wish to emulate.
- Adjust the other options to your liking and needs
- 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 Deploying an Application
# 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.
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):
- Sign in to the Genymotion website (opens new window).
- If you are already Signed in, click on .
- 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.
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
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.
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:
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.|