Tunnel Disconnects

Troubleshoot unexpected tunnel disconnections.

Common causes

• Network instability — The TCP connection between agent and server can drop due to network issues.
• Server restart — If the relay server restarts, all tunnels are lost.
• Idle timeout — Some networks or firewalls close idle TCP connections.
• Resource exhaustion — The server may run out of file descriptors or memory under high load.

Automatic reconnection

Exposr includes automatic reconnection. If the control connection drops, the agent attempts to reconnect and re-register its public port.

Improving stability

• Use a stable internet connection on both the client and server
• Run the relay server on a reliable VPS or cloud VM
• Monitor the server process and restart it automatically (e.g., with systemd)
• Keep Exposr updated