TCP Keep-Alive

How Do I Keep the Connection Alive?

To keep your TCP connection to our server alive and avoid reconnecting, periodically send a request to the /ping endpoint.

---

Strategy

The server supports persistent connections with a keep-alive timeout of 65 seconds. This means:

• If your connection is idle for more than 65 seconds, it will be closed.

• To keep it open, send any request before that timeout expires.

In normal operation you do not need to tear down and re-establish the connection. Keep one warm connection open and reuse it for every submission.

We recommend using the /ping endpoint:

GET /ping

This endpoint is lightweight, fast, and designed specifically to maintain your connection.

---

Suggested Interval

Send a request to /ping every 60 seconds to keep the connection alive reliably.

while true; do
  curl -s https://nozomi.temporal.xyz/ping > /dev/null
  sleep 60
done

---

Notes

• This is not a health check; it's just a way to prevent idle disconnects.

• Avoid pinging more often than needed.

• Reusing one warm connection is the lowest-latency setup. If your workload genuinely cannot keep a connection open and has to reconnect frequently, the QUIC Client reconnects more cheaply.