Install Datalore On-Premises in Docker containers using Docker Compose

Install Datalore

1. Download an archive with the configuration files.

2. To set up Datalore, unpack the downloaded archive and open docker-compose.yaml from the [archive_folder]/docker-compose folder in any text editor. Replace the values of DB_PASSWORD and POSTGRES_PASSWORD properties with any random string (both properties must have the same value). This string will be used as your database password. Make sure you keep it secret.

3. Run the following command and wait for Datalore to start up:

   docker compose up

4. Go to http://127.0.0.1:8080/ and sign up the first user. The first signed-up user will automatically receive admin rights.

5. To access Datalore by a domain other than 127.0.0.1, add a URL with this host as the DATALORE_PUBLIC_URL parameter in the docker-compose.yaml file.

   For example, if you want to use the https://datalore.yourcompany.com domain, add the following:

   services: datalore: ... environment: ... DATALORE_PUBLIC_URL: "https://datalore.yourcompany.com"

6. Click your avatar in the upper right corner, select Admin panel | License and provide your license key.

   

(Optional) Use an external postgres database

1. Add the following variables under environment: in the docker-compose.yaml file:

   environment: ... DB_USER: "<database_user>" DB_URL: "jdbc:postgresql://[database_host]:[database_port]/[database_name]"

2. In the same file, remove the following block:

   postgresql: image: jetbrains/datalore-postgres:2024.4 expose: [ "5432" ] networks: - datalore-backend-network volumes: - "postgresql-data:/var/lib/postgresql/data" environment: POSTGRES_PASSWORD: "changeme"

3. Remove postgresql-data: { } from under volumes:.

Enable an email whitelist

Enable a whitelist for new user registration. Only users with emails entered to the whitelist can be registered.

1. Open the docker-compose.yaml file.

2. Add the following parameter:

   environment: EMAIL_ALLOWLIST_ENABLED: "true"

The respective tab will be available on the Admin panel.

Enable user filtration based on Hub group membership

By default, all Hub users can get registеred unless you disable registration on the Admin panel. If you want to grant Datalore access only to a specific Hub group members, perform the steps below:

1. Open the docker-compose.yaml file.

2. Add the following parameter:

   environment: HUB_ALLOWLIST_GROUP: 'group_name'

Configure notebook code import limit

Set your own value in bytes to configure the limit of notebook code import.

1. Open the docker-compose.yaml file.

2. Add the following parameter:

   environment: VFS_MAX_IMPORT_SOURCE_LENGTH: 'integer, prefixes (K-, M-, etc.) not supported'