Edge randomly disconnects

If an Edge instance repeatedly disconnects and reconnects to the server within a few seconds without an obvious cause, the most likely explanation is unstable network connectivity — low bandwidth, intermittent packet loss, or a NAT/load balancer dropping idle connections. The gRPC keepalive parameters control how the connection is probed and how long both sides wait before declaring it dead.

Before tuning keepalive parameters, verify the network is actually the cause:

• Check Edge logs for connection errors: cat /var/log/tb-edge/tb-edge.log | grep ERROR
• Test round-trip latency to the server: ping server_hostname
• Check for packet loss: mtr server_hostname

If the network is stable and disconnections persist, consider other causes such as resource exhaustion on the Edge device.

Keepalive is configured independently on both sides. Both must be adjusted together — mismatched values will cause the server to terminate connections that the client considers healthy.

export EDGES_RPC_CLIENT_MAX_KEEP_ALIVE_TIME_SEC=1
export EDGES_RPC_KEEP_ALIVE_TIME_SEC=30
export EDGES_RPC_KEEP_ALIVE_TIMEOUT_SEC=25

export CLOUD_RPC_KEEP_ALIVE_TIME_SEC=30
export CLOUD_RPC_KEEP_ALIVE_TIMEOUT_SEC=25

sudo systemctl restart thingsboard
sudo systemctl restart tb-edge

      - EDGES_RPC_CLIENT_MAX_KEEP_ALIVE_TIME_SEC=1
      - EDGES_RPC_KEEP_ALIVE_TIME_SEC=30
      - EDGES_RPC_KEEP_ALIVE_TIMEOUT_SEC=25

      - CLOUD_RPC_KEEP_ALIVE_TIME_SEC=30
      - CLOUD_RPC_KEEP_ALIVE_TIMEOUT_SEC=25