Skip to content
TestsigmaDOCS

Testsigma Tunnel

Setup and Installation: Docker

Prerequisites

Before you begin, ensure that you have referred to:


  1. Create a docker-compose.yml file in your project directory with the following content:

US Region:

services:
testsigma-tunnel:
image: testsigmainc/testsigma-tunnel:<arm64/amd64>-latest
container_name: testsigma-tunnel
environment:
- KEY=<API_KEY>
- TUNNEL_NAME=<NAME_OF_TUNNEL>
- CONNECTIONS=<NUMBER>
- INACTIVE_TIMEOUT=<NUMBER in seconds>
- VERBOSE=true/false

IN Region:

services:
testsigma-tunnel:
image: testsigmainc/testsigma-tunnel-in:<arm64/amd64>-latest
container_name: testsigma-tunnel
environment:
- KEY=<API_KEY>
- TUNNEL_NAME=<NAME_OF_TUNNEL>
- CONNECTIONS=<NUMBER>
- INACTIVE_TIMEOUT=<NUMBER in seconds>
- VERBOSE=true/false

EU Region:

services:
testsigma-tunnel:
image: testsigmainc/testsigma-tunnel-eu:<arm64/amd64>-latest
container_name: testsigma-tunnel
environment:
- KEY=<API_KEY>
- TUNNEL_NAME=<NAME_OF_TUNNEL>
- CONNECTIONS=<NUMBER>
- INACTIVE_TIMEOUT=<NUMBER in seconds>
- VERBOSE=true/false
  1. Replace the placeholder values in the docker-compose.yml file:

    • <API_KEY>: Your Testsigma authentication key.
    • <NAME_OF_TUNNEL>: The name of your tunnel.
    • <NUMBER>: The number of connections to establish.
    • <NUMBER in seconds>: The inactive timeout duration.
    • true/false: Set to true for verbose logging or false to disable it.
  2. Run the following command to start the Testsigma Tunnel service:
    docker compose up -d

  3. Once the service is running, logs will indicate that Testsigma Tunnel is active. Use the tunnel name for your automation tests.

  4. To stop the service, use the following command:
    docker compose down