Run E2E Tests

Trigger a pipeline run for the selected test mode. The job runs on your self-hosted runner.

Branch or tag to run. Keep this aligned with the code you want CI to check out.

Optional. Routes this pipeline to a runner with the entered tag: Leave empty for marsad (the default CI host). Set rog to run on the dev workstation instead.

Desktop and journey suites run the same visible flow through the selected frontend platform.

Virtual/observed is the normal pipeline mode. It can be watched through VNC without logging into the runner GUI.

Desktop/web resize the window. Android/iPhone choose a phone or tablet device.

Optional PNG upload. If provided, it overrides the URL below for this run.

Visible GUI runs apply this PNG before building the app. Leave the default S3 URL unless testing a different icon.

Options

Passes --run-mailhog to pytest. Only useful with custom mode; preset modes set this automatically.

Install schema only — no seed data, admin bootstrap only.

Skip step progress log and pause/stop controls.

Off by default. Stores per-action screenshots in runner/artifacts/screenshots/ for visible GUI suites.

← Back

Viewing GUI Runs

Virtual/headless

Preflight starts Xvfb for the job. This mode is optimized for unattended execution; choose Virtual/observed when you want to watch the run in Remmina.

Virtual/observed

Preflight starts Xvfb and a localhost-only x11vnc viewer automatically. Open your saved Remmina tunnel after preflight starts: Marsad uses localhost:5901; ROG uses localhost:5900 only when explicitly targeted.

Physical/observed

Use this when you need to watch the app live. Log into the runner GUI first. Linux uses that desktop, web opens a headed browser, and Android opens the emulator/device window.

Auto

Auto uses a reachable visible GUI when one exists, otherwise it falls back to the virtual/headless behavior supported by the platform.