Dedicated run tunnel

Tunnels let you run your app from an internal server/localhost and view it in an external browser (proxy).

In some cases you would want to run tests on your own private or internal servers, using a remote selenium grid server, either supplied by Testim or by an external provider such as SauceLabs.


This is a PRO feature

This feature is only open to projects on our professional plan. To learn more about our professional plan, see here.


  1. Tunnel feature enabled.
  2. Testim CLI

How to use it

  1. Run your application server
  2. Run Testim CLI with parameter (--tunnel - default application port 80)
  3. If you run your application under different port than port 80, add parameter (--tunnel-port \<APP PORT e.g. 80>)

Note that Testim CLI will adjust your application base URL to point to the dedicated tunnel address.

Example using Testim CLI with a tunnel

testim --tunnel --tunnel-port <APP PORT default 80> --label "<YOUR LABEL>" --token "<YOUR ACCESS TOKEN>" --project "<YOUR PROJECT ID>" --grid "<Your grid name>" --report-file test-results/testim-tests-report.xml


  1. You can use tunnel for HTTPS address if needed, please contact support to set this up. HTTPS tunnel is only available when running on a Testim-provided grid.
  2. For the grid name, read here how to set up your grid.