Connecting to QuantumGrid – Hub URL & Session Configuration

Start every session against the QuantumGrid hub.

Replace {domain} with your environment.

https://{domain}.testgrid.io/quantumgrid/wd/hub

AndroidDriver driver = new AndroidDriver(
new URL("https://{domain}.testgrid.io/quantumgrid/wd/hub"),
capabilities
);

Use the same base URL for all tests. Do not point different tests to individual Appium node URLs unless your team instructs you to do so.

Session Configuration

QuantumGrid uses capabilities to identify the required device and route the session accordingly.

The capability names should match the values configured in your Appium or Selenium test script (for example, W3C alwaysMatch / firstMatch capabilities).

Supported Capabilities

Capability	Description	Default
appium:platformName or browserName	Specifies the target platform. Use appium:platformName with value “android” or “ios” for mobile. Use browserName with value “chrome” for browser.	Required
appium:platformVersion	Specifies the OS version for automatic device allocation	Optional
appium:udid	Routes the session to a specific device	Optional
tg:userToken	User authentication token	Required
tg:tags	Routes the session to devices matching the specified tag(s). When multiple tags are provided, OR condition is applied.	Optional
tg:queue	Controls whether the session enters the queue if no slot is available. Set to false to fail immediately instead of waiting.	true
tg:queueTimeout	Maximum time (in seconds) the session may wait in the queue before timing out. Minimum: 1s, Maximum: 1800s (30 min).	120
platformTarget	Defines whether to run on a real physical device or a virtual device. Accepted values: "Real" or "Virtual" (for Emulators/Simulators).	Optional

Session Behavior:

• Automatic Device Allocation
  • If only appium:platformName and/or appium:platformVersion are configured (without appium:udid), QuantumGrid automatically selects an available device that matches the requested capabilities.
• Specific Device Allocation
  • If appium:udid is configured, QuantumGrid routes the session to that specific device, subject to availability and queue rules