# AWS Quick start

# Create and set up an instance

  1. Go to Amazon Web Services.

  2. From AWS Marketplace, search for Genymotion.

  3. Select the version of Genymotion Cloud corresponding to the Android version of virtual devices you wish to run. You can run Genymotion virtual devices based on Lollipop AMI (Android 5.1), Marshmallow AMI (Android 6.0), Nougat AMI (Android 7.0), Oreo AMI (Android 8.0) and Pie AMI (Android 9.0).

  4. 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 your use case:

    Description Recommended instance
    Basic Android environment
    Limited graphical interface
    (automation, monitoring, testing)
    t2.small
    Standard Android environment
    Standard graphical interface
    (excluding video streaming and gaming)
    t2.medium
    Professional Android environment
    Good visual performance
    (Video streaming, 2D gaming)
    m4.large
    Professional Android environment
    High-end graphic rendering
    (Better performance for video streaming and 2D gaming)
    m4.xlarge
    Turbocharged Android environment
    (Video streaming, 3D gaming)
    m4.2xlarge
    Turbocharged Android environment, hardware-accelerated GPU display
    (Better performance for video streaming, 3D gaming)
    g2.2xlarge

    A wider range of compatible EC2 instances is available. For more details on instance types, please refer to Amazon EC2 instance types web page.

  5. Click Continue to Subscribe. Review your choices abd accept terms, then click Continue to Configuration.

  6. Review the basic configuration and click Continue to Launch.

  7. EC2 Instance Type: select an instance type in accordance to your choice when subscribing (see step 4).

  8. 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, you can refer to the Requirements - Communication section

    Important

    We do not recommend using the default security group as it is not suitable for Genymotion PaaS.

  9. Key Pair Settings: use this to pair an SSH key. This is required to secure and access an instance from SSH. For instructions, please refer to Access an instance from SSH. Select a key pair if you have already created some, or create a new one.

  10. From the EC2 management console (AWS Management Console > EC2), in Instances, select the instance you want to access.

  11. From the Description tab, copy the hostname or public IP and paste it to your web browser. A connection warning pops up. This happens because the certificate is auto-signed. To avoid this security warning, you must install a trusted certificate, as explained in section Installing a certificate (see Install a valid certificate). Proceed and authenticate.

    Note

    By default, the username is genymotion and the password is the ID of the instance you can retrieve from tab Description.

# Create custom images (templates)

  1. From EC2 Management Console, select an instance and click on Actions > Image > Create Image. This will create an AMI in the geographic zone where the former instance was launched. To use this new image on another geographic zone, select the image in AMIs, then click on Copy AMI > Select the zone.
  2. Follow the standard create instance process from step 7 to create instances from this custom image.

# Access a virtual device from web

Once the initial setup is done, the instance is automatically starts. It can take up to 2 minutes before the instance can be accessed through the browser. Recommended browsers are: Chrome, Opera

From manage EC2 Management console in Instances, select the instance you want to access. In the description section at the bottom, copy the hostname or public IP and paste it to your web browser.

Public DN

You will have this warning because our certificate is autosigned:

Certificate error

If you don’t want a warning, you must install a trusted certificate. Please refer to Installing a valid certificate.

Proceed to the address.
Authenticate yourself:

Authentication

By default, the username is genymotion and the password is the ID of the instance. You can get it here:

Public DNS 2

Note

If you want to change the username and password, please refer to Change authentication.