Self-Signed Certificate (SSL) environment variables

In some infrastructure setups, you might run into problems connecting to Neptune because of the SSL certificate configuration. This can happen if, for example:

• You are in a corporate network, behind a proxy that inspects traffic between your runs and Neptune SaaS.
• The SSL/TLS certificate of your self-hosted installation is not recognized by Python by default.
• The software on your machine is not up to date.

The above problems may result in a NeptuneConnectionLostError. To solve it, set NEPTUNE_VERIFY_SSL to False.

NEPTUNE_VERIFY_SSL

Python package: neptune-scale, neptune-query

If not set, the default value is True.

Linux

Append a line with the export command to your .profile or other shell initialization file:

export NEPTUNE_VERIFY_SSL=False

macOS

Append a line with the export command to your .profile or other shell initialization file:

export NEPTUNE_VERIFY_SSL=False

Windows

In a terminal app, such as PowerShell or Command Prompt, enter the setx command and press enter:

setx NEPTUNE_VERIFY_SSL False

To activate the change, restart the terminal app.

You can also navigate to Settings → Edit the system environment variables and add the variable there.

NEPTUNE_ALLOW_SELF_SIGNED_CERTIFICATE

Python package: neptune-scale

Deprecated in 0.23.0. Use NEPTUNE_VERIFY_SSL instead.

If not set, the default value is False.

Linux

Append a line with the export command to your .profile or other shell initialization file:

export NEPTUNE_ALLOW_SELF_SIGNED_CERTIFICATE=True

macOS

Append a line with the export command to your .profile or other shell initialization file:

export NEPTUNE_ALLOW_SELF_SIGNED_CERTIFICATE=True

Windows

In a terminal app, such as PowerShell or Command Prompt, enter the setx command and press enter:

setx NEPTUNE_ALLOW_SELF_SIGNED_CERTIFICATE True

To activate the change, restart the terminal app.

You can also navigate to Settings → Edit the system environment variables and add the variable there.