Skip to content

Neptune connection lost#

Error

NeptuneConnectionLostException: ...

This error indicates that the Neptune client lost connection to the server. This can happen for various reasons, such as network issues or server downtime. Most often, it's temporary and resolves itself.

If the issue does not resolve itself, follow the steps below to troubleshoot the problem:

  • To allow the client to connect to the server with a self-signed certificate, set the NEPTUNE_ALLOW_SELF_SIGNED_CERTIFICATE environment variable to true.

  • If the issue is still not resolved, execute the following command to check the connection between the Neptune client and server:

    curl https://app.neptune.ai
    

Self-hosting? See Troubleshooting self-hosted Neptune.

If the output is an HTML string, it indicates that the connection is fine and there might be some other issue. Reach out to Neptune support via chat or support@neptune.ai with the output.

Example output
<!doctype html>
<html>
<head>
  <!-- neptune-frontend version: xxxxxxxx -->
  <meta charset="utf-8">
  <title>neptune.ai</title>
  ...
</html>

Other results, such as curl: (6) Could not resolve host: app.neptune.ai, indicate a connection issue. In this case,

  1. Check for any outages in Neptune's status page.
  2. Check your network settings. Your IT/DevOps team can help you with this.