Skip to content

Automate instance parameters

12.0.0

This feature is not available with MS Azure and Oracle Cloud Infrastructure providers.

This chapter covers alternative methods to modify instances settings to ease deployment and post-deployment configuration.

To do so, we will be using the user data parameters , to set or modify the following parameters:

*only available with Android 10-14 images ver. 14.0.0.

More parameters will be added in the future.

Parameters and code

User parameters are in JSON format: { "parameter": "value" } .

Supported objects and parameters are:

applyEveryBoot

Apply parameters values after every boot.
Type: Boolean
Default: false

configuration

Set various parameters.

adb

ADB parameters.

active

Disable or enable ADB.
Type: Boolean
Default: false

authentication

Configure authentication.

enable

Enable or disable authentication.
Type: Boolean
Default: true

username

User Name.
Type: String (SHA-1)

password

Password.
Type: String (SHA-1)

root

Toggle root access.

active

Enable or disable root. Type: Boolean Default: false

hwProfile

Virtual Device hardware settings.

displaySettings

Display settings.

displays

Display settings for current display.

width

Display width (px).
Type: Integer
Default: 600

height

Display height (px).
Type: Integer
Default: 1024

density

Display density (ddp).
Type: Integer
Default: 180

contentPadding

Padding (dp) around status bar elements near the edge of the screen.
Type: Integer Default: 0

topCornerRadius

Radius (dp) of the rounded corners at the top of the display.
Type: Integer
Default: 0

bottomCornerRadius

Radius (dp) of the rounded corners at the bottom of the display.
Type: Integer
Default: 0

user_dns

Domain for SSL certificate.
Type: String

Username and Password

The username and password objects value must be encoded in SHA-1.

For example, if you wish to set "genymotion" username and "genYm01!" password:

  1. Encode the strings into SHA-1:

    $ echo -n "genymotion" | openssl sha1
    (stdin)= 0db0f30519f66ad6c9f4b42df56a7e08102e8374
    
    $ echo -n "genYm01!" | openssl sha1
    (stdin)= 2eaa80a32c113dfe583f3d6120425fec54b89dd8
    
  2. Add in your JSON:

    {
        "configuration": {
            "authentication": {
                "enable": "true",
                "username": "0db0f30519f66ad6c9f4b42df56a7e08102e8374",
                "password": "2eaa80a32c113dfe583f3d6120425fec54b89dd8"
            }
        }
    }
    

Example

{
    "applyEveryBoot": true,
    "configuration": {
        "adb":  {
            "active": true
        }, 
        "authentication": {
            "enable" : true,
            "username": "0db0f30519f66ad6c9f4b42df56a7e08102e8374",
            "password": "2eaa80a32c113dfe583f3d6120425fec54b89dd8"
        },
        "root": {
            "active": true
        }
    },
    "hwProfile": {
        "displaySettings": {
            "displays": [ {
                "width": 768, 
                "height": 1280, 
                "density": 160,
                "contentPadding": 125,
                "topCornerRadius": 125,
                "bottomCornerRadius": 0
                }
            ]
        }
    }, 
    "user_dns": "genymotion.com"
}
Back to top