Troubleshooting

Common issues and their solutions.

Connection Issues

"Connection refused" error

Cause: Your local service is not running or is on a different port.

Solution:

1. Make sure your local service is running
2. Verify the port number matches your tunnel configuration
3. Check if the service is bound to localhost or 0.0.0.0

# Check if something is running on port 3000
netstat -tlnp | grep 3000  # Linux
lsof -i :3000              # macOS

"Invalid token" error

Cause: The token is incorrect or has been regenerated.

Solution:

1. Go to your dashboard
2. Copy the token again (make sure to copy the entire string)
3. Check for extra spaces or missing characters

Tunnel disconnects frequently

Cause: Network instability or firewall issues.

Solution:

1. Check your internet connection
2. Try a wired connection instead of WiFi
3. Check if your firewall is blocking outbound connections
4. The client will auto-reconnect, but persistent issues may indicate network problems

"Subdomain already taken" error

Cause: Someone else is using that subdomain.

Solution:

1. Choose a different subdomain
2. Try adding numbers or your username (e.g., myapp-john)
3. Check if you already have a tunnel with that subdomain

Client Issues

GUI app wont open on macOS

Cause: macOS Gatekeeper is blocking the app.

Solution:

# Remove quarantine flag
xattr -c InTunnel-GUI-macOS-*

# Or right-click → Open

GUI app wont open on Windows

Cause: SmartScreen is blocking the unsigned app.

Solution:

1. Click "More info"
2. Click "Run anyway"
3. This is normal for new/unsigned applications

CLI shows "permission denied"

Cause: The file is not executable.

Solution:

chmod +x InTunnel-Linux

Client crashes immediately

Cause: Wrong architecture or corrupted download.

Solution:

1. Verify you downloaded the correct version for your system
2. Re-download the file
3. Check the SHA256 checksum on the download page

Account Issues

Forgot password

1. Go to login page
2. Click "Forgot Password"
3. Enter your email
4. Check your inbox for reset link

Not receiving emails

1. Check spam/junk folder
2. Add noreply@intunnel.cloud to contacts
3. Try a different email address

Account locked

Cause: Too many failed login attempts.

Solution: Wait 15 minutes and try again, or contact support.

Performance Issues

Tunnel is slow

Possible causes:

1. Your local service is slow
2. Network latency
3. Large file transfers

Solutions:

1. Test your local service directly first
2. Check your internet speed
3. Consider using a server closer to your location

High latency

Cause: Geographic distance to InTunnel server.

Solution:

1. Our servers are in Europe
2. Latency is normal for distant locations
3. For production use, consider a dedicated tunnel server

Still need help?

• Check our FAQ
• Open an issue on GitHub
• Contact: support@intech-eg.tech