Datalore 2025.3 Help

Set up an air-gapped environment (no HTTP proxy available)

By default, Datalore does not bundle JDBC drivers in order to have a smaller size of the SQL runtime image — the required drivers for the attached database connections are downloaded on-demand during the SQL runtime initialization.

Follow the procedure below to preload the required JDBC drivers and set up your custom SQL runtime image to use Datalore in an air-gapped environment.

Set up a fully air-gapped environment (no HTTP proxy available)

  1. Rebuild the datalore-database-command image.

    Pass a list of the required JDBC drivers to the utility script to pre-download them and bundle with the resulting image. See the example below.

    Dockerfile

    FROM jetbrains/datalore-database-command:2025.3.1 RUN ["/opt/datalore/download_artifacts.sh", "{artifact name}:{version}"]
  2. After the above-mentioned custom image is built, update the Datalore server configuration to use it.

    Add the DATABASES_COMMAND_IMAGE variable to the Datalore environment as shown in the examples below.

    docker-compose.yaml

    services: datalore: ... environment: ... DATABASES_COMMAND_IMAGE: "datalore-db-command-custom:latest" ...

    datalore.values.yaml

    ... dataloreEnv: ... DATABASES_COMMAND_IMAGE: "datalore-db-command-custom:latest"
  3. Restart the Datalore server to apply the changes.

Examples

Dockerfile

FROM jetbrains/datalore-database-command:2025.3.1 RUN ["/opt/datalore/download_artifacts.sh", "'MySQL Connector/J 8'"] RUN ["/opt/datalore/download_artifacts.sh", "'Redshift:2.0.0.7'"] RUN ["/opt/datalore/download_artifacts.sh", "'PostgreSQL:42.3.3'"]

Known limitations

If the clients’ browser is also running in a fully air-gapped environment, the Visualize tab in a rendered DataFrame will not work due to this functionality reliance on the public CDN availability, which is not possible in an air-gapped environment.

Last modified: 31 May 2025