Skip to content

Automate instance parameters

12.0.0

This feature is not available on Azure.

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"
}