Skip to content

Connection Testing

Test whether a tunnel configuration works before you use it.

Running a Test

  1. Open the tunnel in StormTunnel
  2. Click Test in the Status section
  3. Wait for the result (usually 1-2 seconds)

A green checkmark means the configuration is valid. A red X means something is wrong -- read the error message.

Before You Test

Make sure you have filled in all required fields: name, host, port, and authentication. Verify you have the correct SSH key or password and that you have internet connectivity.

Common Errors

"Port X is already in use"

  • Stop the other tunnel using that port, or choose a different local port.

"Connection refused"

  • Check hostname/IP address is correct
  • Check SSH port (usually 22)
  • Verify server is online
  • Check firewall is not blocking the connection

"Permission denied" or "Authentication failed"

  • Verify you are using the correct SSH key
  • Ask your admin to verify your key is on the server
  • Check SSH key passphrase if the key is encrypted

"Connection timed out"

  • Check your internet connection
  • Try a different network
  • Verify server is reachable
  • Check for firewall blocking the connection

"AWS Session Manager error"

  • Ask your admin to verify AWS configuration
  • Check EC2 instance is running
  • Verify your AWS profile is correct

When a Test Fails

  1. Read the error message -- it identifies the problem
  2. Check common causes: wrong hostname, wrong port, missing key, server offline, firewall
  3. Ask your admin if you need help with the server-side configuration