Skip to content

AWS

This section describes the required steps to deploy and use instances on AWS. Basic knowledge of how AWS works and AWS main concepts are required. Depending on your settings, expected deployment time should take 5 to 10 minutes.

Genymotion Device Image is available for all regions, except China.

Data is encrypted using Android encryption on Android 8.0 images and above. There is no data encryption with Android 5.1, 6.0 and 7.0 images.

Available Android images

We offer ARM64 and x86_64 images with the following Android versions:

  • 16.0 (beta)
  • 15.0
  • 14.0 Automotive OS (beta)
  • 14.0
  • 13.0
  • 12.1
  • 12.0
  • 11.0
  • 10.0
  • 9.0 Pie (No longer supported)
  • 8.0 Oreo (No longer supported)
  • 7.0 Nougat (No longer supported)
  • 11.0
  • 10.0
  • 9.0 Pie (No longer supported)
  • 8.1 Oreo (No longer supported)
  • 8.0 Oreo (No longer supported)
  • 6.0 Marshmallow (No longer supported)
  • 5.1 Lollipop (No longer supported)

Create and set up an instance

  1. Go to AWS Marketplace
  2. Select the version of Android OS and architecture (x86_64 or arm64) for your Genymotion instance.

  3. In the EC2 Instance Type section, select an instance corresponding to your needs. You can refer to the table below to know which instance to select depending on the architecture and your use case:

    c6g.medium arm instance type is incompatible and not available for Android 10+ images.

    c6g is recommended over m6g because ARM64 instances need less RAM than x86_64 ones, since there is no translation layer.

    Usage ARM64 x86_64
    Basic Android environment
    Automation, monitoring, testing, no graphical interactions    		 t4g.small t3.small
    Low-profile Android environment
    Basic interactions, not suitable for video streaming or gaming    		 t4g.medium t3.medium
    Standard Android environment
    Common usage, suitable for low-res video streaming or 2D games    		 c6g.large m5.large
    Professional Android environment
    Better performance for basic video streaming and 2D games    		 c6g.xlarge m5.xlarge
    High-end Android environment
    High-res Video streaming, 3D games    		 c6g.2xlarge m5.2xlarge

  4. Click Continue to Subscribe. Review your choices and accept terms, then click Continue to Configuration.

  5. Review the basic configuration and click Continue to Launch.
  6. EC2 Instance Type: select an instance type in accordance to your choice when subscribing (see step 4).

  7. Security Group: create a new security group (Create New Based On Seller Settings) if you need specific EC2 security/firewall settings. To help you choose the best settings for you, please refer to the Requirements.

    It is not recommended to use the default security group.

  8. In Key Pair Settings, you can select a key pair if you have already created some, or create a new one. This is recommended if you need to access the instance with SSH.

  1. In the EC2 Dashboard, click Launch instance and select Launch instance

    Launch instance

  2. Give a name to your instance in the Name and tags field:

    Name

  3. In Application and OS images (Amazon Machine Image), type "Genymotion" in the search bar and press return:

    AMI

  4. Select AWS Marketplace AMIs and choose the Genymotion image you wish to subscribe to:

    Marketplace

  5. Review the product pricing and conditions of use, and click Continue

  6. Select the instance best suited to your need with the instance type drop-down button. Recommended types are:

    The t2 and m4 x86_64 instance types are not suitable for Genymotion.

    c6g.medium arm instance type is incompatible and not available for Android 10+ images.

    Usage ARM64 x86_64
    Basic Android environment
    Automation, monitoring, testing, no graphical interactions    		 t4g.small t3.small
    Low-profile Android environment
    Basic interactions, not suitable for video streaming or gaming    		 t4g.medium t3.medium
    Standard Android environment
    Common usage, suitable for low-res video streaming or 2D games    		 c6g.large m5.large
    Professional Android environment
    Better performance for basic video streaming and 2D games    		 c6g.xlarge m5.xlarge
    High-end Android environment
    High-res Video streaming, 3D games    		 c6g.2xlarge m5.2xlarge

    c6g is recommended over m6g because ARM64 instances need less RAM than x86_64 ones, since there is no translation layer.

  7. If you already have an SSH key pair, you can use the drop-down button in the Key pair (login) section to associate the pair with the instance, or create a new key pair.

  8. In Network settings, you can either create a new security group (default), or use already existing groups.

    • If you choose to create a new security group, make sure to add and setup rules required to your needs. For recommended security settings, please refer to Requirements.

    • To choose an already existing group, click Edit in the upper-right corner of the section:

      network

  9. In Configure storage, you can change the internal storage size and type, or add external storage.

Advanced details

You can adjust advanced settings in this section, but we do not recommend altering them unless you are an experienced AWS user.

Click Launch instance when you are set to create and launch the new instance.

EC2 security groups

For recommended security settings, please refer to Requirements.

Ports access is configured in a security group that contains all the firewall rules. To edit those rules:

  1. Go to Network & Security > Security groups.
  2. Select the security group associated with your virtual device.
  3. From tabs Inbound or Outbound, click Edit.
  4. Edit rules according to your needs.

Deployed resources

The EC2 Auto-assign Public IP feature is enabled by default. Make sure to setup your EC2 security group correctly to avoid any unauthorized connections to your instance.

Once done, an instance with the following resources will be deployed and started:

  • AMI: The Genymotion Amazon Machine Image (AMI) you subscribed to. AMI Information contains the Genymotion and Android versions.
  • Security group: The EC2 security group of the instance.
  • Network interface: The EC2 network interface attached to the instance.
  • Storage: The Elastic Block Store (EBS) volume(s) attached to the instance.

User Data

  • User Data is located in the /data partition.

  • Data is encrypted using Android encryption with Android 8.0 images and above.

    There is no data encryption with Android 7.0, 6.0 and 5.1 images!

Access an instance with a web browser

Once the initial setup is done, the instance is automatically started. It can take up to 2 minutes before the instance can be accessed through the web browser.

From the EC2 dashboard, select the instance you want to access. In the Details section at the bottom, copy the hostname or public IP and paste it to your web browser, or click open address :

Public IP

You will have this warning because our certificate is self-signed:

Certificate error

To remove this warning permanently, you must install a trusted certificate.

Click Advanced and proceed to the address. Authenticate yourself:

Authentication

By default, the username is genymotion and the password is the instance ID:

Instance ID

To change the default username and password, or disable authentication, please refer to Change authentication.