Connection Problems

Troubleshoot connection issues with Exposr.

Cannot connect to server

Possible causes:

• The relay server is not running
• The server IP address is incorrect
• A firewall is blocking outbound connections to port 9000
• The server's firewall is blocking inbound connections on port 9000

How to diagnose:

# Test TCP connectivity to the control port
telnet YOUR_SERVER_IP 9000

# Or use nc
nc -zv YOUR_SERVER_IP 9000

How to fix:

• Verify the server is running with exposr server start
• Check the configured server address in ~/.exposr/config.json
• Ensure port 9000 is open on the server's firewall

Connection refused

Possible causes:

• The Exposr server process is not running
• The server is running on a different port

How to fix:

• Start the server with exposr server start
• Check if the server is listening: ss -tlnp | grep 9000

Server not configured

[ERROR] Server IP is not configured. Run: exposr config set-server <server-ip>

How to fix:

exposr config set-server YOUR_SERVER_IP

Token mismatch

If the agent connects but the tunnel fails to register, the agent token may not match the server's configured token.

How to fix:

• Check the token in ~/.exposr/agent_token.txt on the client
• Ensure the same token is configured on the server with exposr server init-token