Skip to content

Connection Testing

StormTunnel includes a simple connection testing feature that helps you verify your tunnel configuration works before using it.

Quick Test

To test a tunnel:

  1. Open the tunnel in StormTunnel
  2. Click the Test button in the Status section
  3. Wait for the result (usually 1-2 seconds)
  4. ✅ Green checkmark = works
  5. ❌ Red X = something's wrong (see error message)

Understanding Test Results

Success ✅

Your tunnel configuration is correct and ready to use.

Failure ❌

Check the error message shown. Common issues:

Best Practices

Before testing:

  • Fill in all required fields (name, host, port, authentication)
  • Verify you have the correct SSH key or password
  • Check you have internet connectivity

When Test Fails

  1. Read the error message - it explains the problem
  2. Common causes:
    • Wrong hostname or IP address
    • SSH port incorrect (default is 22)
    • SSH key not on the server
    • Server is offline or unreachable

    Common Issues

"Port X is already in use"

  • Stop the other tunnel using that port
  • Choose a different local port

"Connection refused"

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

"Permission denied" or "Authentication failed"

  • Verify you're using the correct SSH key
  • Ask your admin to verify your key is on the server
  • Check SSH key password if encrypted

"Connection timed out"

  • Check your internet connection
  • Try a different network or Wi-Fi
  • Verify server is reachable and online
  • 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 Test Fails

  1. Read the error message - it explains the problem
  2. Common causes:
    • Wrong hostname or IP address
    • SSH port incorrect (default is 22)
    • SSH key not on the server
    • Server is offline or unreachable
    • Network/firewall blocking connection
  3. Ask your admin if you need help fixing the configuration

Last Updated: 2025-11-20 Version: StormTunnel v1.1 (Status Integration) Related Topics: Creating Tunnels, SSH Authentication, Troubleshooting