Ask the Community
Device tunneling
Connect remote BrowserStack devices to your local machine with Device tunneling. Run tests with any framework using native tools like adb and libimobiledevice.
Device tunneling lets you connect a remote BrowserStack real device directly to your local machine, making it behave as if it were physically connected using USB.
Device Tunnel is anchored to a BrowserStack Appium session to capture logs, video, and other essential artifacts for your test.
Prerequisites
Before you begin, ensure you have the following:
-
A BrowserStack Username and Access Key. You can obtain your
userNameandaccessKeyfrom the Account & Profile section on the dashboard.
If you have not yet created an account, sign up for a free trial. -
The BrowserStack SDK CLI installed on your machine. You can download the SDK CLI for your platform by clicking the appropriate link below:
- macOS:
- Linux:
Key benefits
-
Use native tools: Use command-line tools you already know, like ADB for Android and libimobiledevice for iOS.
-
Test any custom framework: Since the device behaves like a local one, you can run tests with any custom framework or protocol, without needing specific platform integrations.
-
Full control: Interact with the device in real-time. Inspect logs, run shell commands.
-
High performance: Experience low latency and high throughput for a responsive testing experience, thanks to direct device connections.
-
Stable & reliable: The tunnel features automatic connection recovery and efficient resource pooling to ensure your sessions remain stable.
-
Run concurrent tests: Scale your testing by running multiple device tunnels simultaneously.
Next steps
Get started with device tunneling - Install the tool and run your first tunnel.
Related topics
- Advanced Configuration - Customize tunnel settings for performance and security.
- iOS Setup Guide - Configure your macOS environment for iOS device tunneling.
- CLI reference & management - Explore command-line options for managing device tunnels.
- Troubleshooting guide - Find solutions to common issues with device tunneling.
We're sorry to hear that. Please share your feedback so we can do better
Contact our Support team for immediate help while we work on improving our docs.
We're continuously improving our docs. We'd love to know what you liked
We're sorry to hear that. Please share your feedback so we can do better
Contact our Support team for immediate help while we work on improving our docs.
We're continuously improving our docs. We'd love to know what you liked
Thank you for your valuable feedback!