Run tests in your local environment
The Tunnel makes it easy to run Selenium tests in your private staging environment.
You might want to test a new feature or a big refactor of your local code, to make sure all regression tests still pass.
With our Tunnel this is very easy to do. All you need to do is point your tests to http://localhost and port 4445 instead of using our grid http://hub.testingbot.com port 4444.
The Tunnel is a Java based program (jar) which contains our very own secure HTTP(s) proxy, which will relay requests to our grid.
Optimised for Speed
Setting up a Tunnel means we boot a pristine VM server just for you. This takes about a minute to launch.
We added an accelerator on our end of the tunnel, which will cache static content flowing through the tunnel.
The Tunnel uses compression to minimize the traffic going through the tunnel.
It is possible to run multiple tunnels with one account. This means you can dedicate a number of machines on your private network to run a number of tunnels. This makes for a great High-Availability setup.
Every request to and from our servers will pass through the Tunnel, which is based on the SSH protocol.
A fresh VM is booted up just for you, and when your tests are finished, the tunnel and VM server will be destroyed.
We've built a strong Tunnel which can handle a lot of traffic, even during parallel testing.
The Tunnel is built with Java and runs on any standard JVM.
Both HTTP and HTTPS usage is supported inside the tunnel.
The standalone tunnel application runs on all major Operating Systems: Windows, Linux and macOS.
Setting up and using the Tunnel is easy.
Download the JAR file from our website and run it on your commandline.
All you need to do is replace the
API_SECRET with your own key and secret.
You will see "You may start your tests" when your Tunnel is ready.
The Tunnel will create a
~/.testingbot file on your local system where it saves the
This way, you can save the necessary credentials in the file and then just start the tunnel without passing credentials to the tunnel.
The system requirements depend on how you are going to use the tunnel.
If you intend to do parallel testing, you will need to increase the CPU and RAM of the machine running the tunnel.
A machine with 4GB ram and 3GHz processor should run the Tunnel just fine.
Shutting down tunnel
It is recommended to do a graceful exit of the tunnel every time, otherwise the tunnel will remain active in our system since we never received a shutdown command.
To do a graceful exit, please use
CTRL+C in the process window or remove the TestingBot pid file. This will trigger a graceful exit, send the shutdown command to TestingBot and clean up everything.
We have created a NodeJS based launcher which you can use in your NodeJS tests and projects: