Skip to content

Settings

The Settings page lets you configure the runtime parameters that are passed to your test client at the start of every test run. These values appear in the HTML test report and can be read by your test scripts at runtime.

Click Settings in the left sidebar.

Settings page showing runtime parameters

Runtime Parameters

Runtime parameters are key–value pairs stored in runtime_params.json next to your main.py test client. They are loaded once when a test run starts and are available throughout the run.

Default Parameters

XPressRT ships with four pre-defined parameters:

Key Description Example value
device_under_test_name Name or model of the device being tested MyBoard-X2
device_under_test_version Firmware or hardware version v1.7.3
tester_name Name of the person or organisation running the tests ml&s GmbH & Co. KG
test_place_name Location of the test bench Testplatz 1

These values are embedded in every HTML test report under the run metadata section.

Editing Parameters

  1. Click the Value field next to any parameter key to edit it.
  2. When you are done, click Save to write the changes to runtime_params.json.

Warning

The Save button must be clicked explicitly — navigating away without saving will discard any unsaved changes.

Base Path

The Base Path is not part of the Settings page itself, but it is the most important configuration item in XPressRT. It is shown in the top header on every page.

The base path tells the backend where your test project lives on disk. It should point to the folder that contains:

  • Your .feature files (in a features/ subdirectory)
  • Your main.py test client
  • Your runtime_params.json file

To change the base path:

  1. Click the folder icon next to the Base Path field in the header.
  2. Type the new path (relative to the Docker working directory, e.g. app/examples/client).
  3. Click the Save icon (💾) that appears.

XPressRT will re-scan the directory and reload the feature list.

Note

Changing the base path while a test is running will not affect the running test. The new path takes effect on the next test execution.

Observer Mode Password

The Observer Mode password is not configurable through the UI. It is stored in the backend config.json file under the key observerModePassword. The default password is 123.

To change it, ask your system administrator to edit config.json in the backend container and restart the service.