DeviceLab Documentation

Turn Your Devices Into a Distributed Testing Lab

One command. Done. Globally accessible. No code changes. No tunnels. No compromises.

What is DeviceLab?

DeviceLab is distributed device lab software that turns your team’s devices into a globally accessible testing lab. Connect devices from anywhere - office, home, different countries - and access them from your laptop, CI/CD, or anywhere with internet.

Key Benefits:

  • Global access to your devices - Test on devices anywhere in the world
  • Real devices + emulators - Physical phones, tablets, simulators, emulators
  • Data stays on your network - Zero-trust P2P architecture
  • Works with existing tools - Maestro, Appium, Espresso, XCUITest
  • No code changes - Your tests work unchanged

How It Works

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│   Device Node   │◀───▶│    DeviceLab    │◀───▶│   Test Node     │
│                 │ P2P │     Server      │ P2P │                 │
│ • Your devices  │     │                 │     │ • Your tests    │
│ • Your network  │     │ • Coordination  │     │ • Your CI/CD    │
│ • Your control  │     │ • No data store │     │ • Your laptop   │
└─────────────────┘     └─────────────────┘     └─────────────────┘

Step 1: Connect Devices

Run on any machine with devices (Mac, Linux, anywhere):

bash 
curl -fsSL https://app.devicelab.dev/device-node/YOUR_ORG_KEY | sh

Step 2: Run Tests

Run from your laptop, CI/CD, or anywhere:

bash 
curl -fsSL https://app.devicelab.dev/test-node/YOUR_ORG_KEY | sh -s -- \
  --framework maestro \
  --app ./app.apk \
  --tests ./maestro-tests/

Step 3: That’s It

Your tests work unchanged. Remote devices behave like local devices.

Why DeviceLab?

Problem DeviceLab Solution
Cloud Labs: $250/device/month for devices you own Use YOUR devices, save 60%
DIY Infrastructure: Weeks to build, constant breakage One command, zero maintenance
Stay Local: No CI/CD, no remote access Global access instantly

What Makes It Different

Feature Cloud Labs DIY DeviceLab
Setup time Hours Weeks 1 minute
Your devices No Yes Yes
Data privacy Their servers Your servers P2P (no middleman)
Maintenance Managed You manage Zero
Price $250/device/mo Engineering time $99/device/mo

Supported Devices

  • Physical devices: Any Android phone/tablet, any iPhone/iPad
  • Emulators: Android emulators (as many as your CPU allows)
  • Simulators: iOS simulators on Mac
  • Mix and match: 5 physical + 10 emulators = 15-device lab

Supported Frameworks

Framework Android iOS Code Changes
Maestro ✅ ✅ None
Appium ✅ ✅ None
Espresso ✅ - None
XCUITest - ✅ None

Security

DeviceLab uses zero-trust architecture:

  • Peer-to-Peer: Data flows directly between YOUR machines via WebRTC
  • End-to-End Encryption: DTLS-SRTP encryption, only your nodes can decrypt
  • Minimal Data: We store device info and test results (pass/fail/error). Logs are optional - you choose whether to store them
  • Local Execution: Tests run on YOUR test node, apps run on YOUR device node

Documentation

Getting Started

Guides

Reference

Help

  • FAQ - Common questions