Skip to main content
A session is a live device instance you can interact with directly. Start one from the dashboard or via the CLI/API, and you get a real iOS or Android device streamed to your browser. Sessions come from many sources and feed into one live device instance

Starting a Session

  1. Go to Sessions and click Start session
  2. Pick a platform (iOS or Android), device model, and OS version
  3. Optionally select an App and Build to pre-install
  4. Set an idle timeout (5m, 15m, 30m, or 1h)
  5. Click Start
The device boots and streams to your browser in 1–5 seconds on both iOS and Android. Non-default device targets (specific models or OS versions) may take longer to provision. Tap, swipe, type, and interact with it like a real phone.

What You Can Do

  • Manually explore your app before writing tests
  • Debug a specific flow on a specific device/OS combo
  • Record your interactions and compile them into a test
  • Set GPS location, open deep links, trigger device actions

Session Sources

Sessions can come from anywhere:
SourceHow
UIStart from the dashboard
CLIrevyl device start
APIPOST /api/v1/execution/start_device
CI/CDTriggered from a pipeline
WorkflowSpawned by a workflow run

Active Sessions

The sessions page shows all live sessions with real-time status, elapsed time, and an idle indicator. Sessions that sit idle for more than 2 minutes get flagged. You can stop any session from the list.

Session History

Past sessions are listed with device info, duration, source, and user. From here you can: