# Oracle Cloud Quick Start

Genymotion Device image (PaaS) is now available on Oracle Cloud Infrastructure (OCI) from version 11.0.0 onward. It runs on Ampere Computing platform, based on Arm which offers native arm64/aarch64 support. Currently, we offer an arm64 Android 8.0 (Oreo) image but more will be added in the future.

Note

Launching a Genymotion instance is very similar to launching a Linux instance. We recommend reading Oracle's documentation article, Tutorial - Launching Your First Linux Instance (opens new window) as a complement to the following guide.

# First steps

  1. Go to Oracle Cloud Marketplace (opens new window) and search for "Genymotion": Marketplace

  2. Select the version of Android OS for your Genymotion instance. You can run Genymotion virtual devices based on Oreo (Android 8.0) - more versions will be added in the future.

  3. Select the Genymotion emulator version and compartment of the instance: Version

  4. Check I have reviewed and accept the Oracle Terms of Use and the Partner terms and conditions. and click Launch Instance

  5. Setup your instance parameters:

    • Name: Set a name for your instance. The default name is instance-YYYYMMDD-HHMM but we recommend using an explicit name.
    • Create in compartment: Select the compartment (opens new window) where you wish to create the instance.
    • Placement: Select the availability domain (opens new window) for your instance.
    • Image and Shape: The Image is the one you selected on the Marketplace - you can click Return to marketplace to change it. The default Shape (opens new window) is VM.Standard.A1.Flex.
    Customize Shape

    Genymotion Device image (PaaS) runs on Ampere Computing platform, which corresponds to the compute shape (opens new window) VM.Standard.A1.Flex with 1 core OCPU, 6 GB memory and 1 Gbps network bandwidth.

    If you wish to add more OCPU or RAM, click Change Shape and change the settings to fit your needs:
    Oracle Shape

    Warning

    Make sure to select an Ampere ARM-based Virtual Machine - any other virtual machine type will not work with Genymotion current image.

  6. Setup your instance network (opens new window) parameters: Oracle networking

    • Network: Select or create virtual cloud network (VCN) for your instance. You can also add your instance to an existing OCID subnet by choosing Enter a subnet OCID.
    • Subnetwork: Select or create a subnet for your instance.
    • Public IP Address: Assign an IPv4 public address to your instance.

    Important

    A public IP is required to access your instance from the Web. If you need to access the instance from a secured network, or if assigning a public IP is against your security requirements, please refer to Access an instance from an Entreprise network (NAT).

  7. Click Show advanced option, check Use network security groups to control traffic and select a Network Security Groups (opens new window) from the drop-down list in order to secure access to the instance: NSG 0

  8. Add an SSH key (optional): Oracle add ssh Adding a SSH key is necessary if you need to access your instance from SSH or use a SSH tunnel. For more details, please refer to Access an instance from SSH.

    You can either generate an SSH key pair (opens new window), or upload a public key that you already have.

  9. Click Create to create and launch the instance.

Note

The Boot volume options are not available with Genymotion Device image - you can ignore them.

# Network security

You need to attach the instance to one or more Network Security Groups (opens new window) (NSG) in order to manage and secure access to your instance.

For recommended security settings, please refer to Requirements - Networks security.

You can attach your instance to Network Security Groups when creating an instance or from the instance dashboard:

NSG

# Create custom templates

  1. Select the instance you wish to use as a template.

  2. From the instance dashboard, click More actions > Create Custom Image: Create Custom Image

    Note

    If this instance is running, it will be automatically shut down.

  3. Select the compartment and give a name to your custom image. Click Create Custom Image when done.

  4. From your instace dashboard (Compute > Instances), click Create instance: Create instance

  5. Setup your instance parameters like a new instance (see First steps), but select Change image to use your Custom image: Select Custom image

  6. Select Custom image from the Image source drop-down list, the compartment where you saved your custom image and select the custom image from the list. Finally, click Select image: Get ready

  7. Finish setting up your instance (see First steps) and click Create when done.

This will create a new instance with the custom image you created in step 2.

# Access a virtual device from the Web

Important

Please refer to Requirements for recommended browsers and network security settings.

To access a virtual device webUI, you need to set a public IP to your virtual machine. See First steps.

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.

  1. From the Compute > Instances dashboard, select the running instance(s): Instances dashboard
  2. Copy the Public IP Address and paste it in a new window or tab: Public Ip
  3. A connection warning pops up: Warning This happens because the certificate is auto-signed. To avoid this security warning, you must install a trusted certificate, as explained in section Install a valid certificate.
  4. Ignore the warning: click Advanced and Proceed to {your_instance_punlic_IP}(unsafe)
  5. The default username is genymotion and password is the name of your instance (for example, instance-20210623-1701). To change these credentials, please refer to Change authentication.

Note

If you are behind a secured network, such as a company network, please see Access from a Company network