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)
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}"]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"Restart the Datalore server to apply the changes.
Examples
Dockerfile
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.