Datalore 2023.1 Help

Install Datalore Enterprise in Docker containers using Docker Compose

The instruction in this article describes the installation of Datalore Enterprise in Docker containers using Docker Compose. We recommend that you choose the Docker-based installation if your primary goal is to get familiar with the product and its key features. This is the easier and quicker procedure compared to the Helm-based method.


Before installation, make sure that you have the following:

  • Docker

  • Docker Compose V2

To check the requirements, execute docker compose version.

Expected result:

$ docker compose version Docker Compose version v2.2.3

Hardware requirements
  • Datalore server machine: 4GB of RAM (the number of CPU is irrelevant if the load is not high)

  • For every concurrently run notebook: from 4GB of RAM

Basic Datalore installation

Follow the instruction to install Datalore using the selected method.

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 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, 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 domain, add the following:

    services: datalore: ... environment: ... DATALORE_PUBLIC_URL: ""
  6. Click your avatar in the upper-right corner, select Admin panel | License and provide your license key.

    Opening Admin panel

Further steps

Follow the basic installation with configuration procedures. Some of them are required as you need to customize Datalore Enterprise in accordance with your project.




Configure Docker Swarm agents

Used to connect multiple machines to your Datalore installation

Configure agents

Used to change the default agents configuration

Set up GPU machines

Used to enable GPU machines

Configure plans

Used to customize plans for your Datalore users


Customize or update environment

Used to create multiple base environments out of custom Docker images

Set up JetBrains Hub

Used to integrate an authentication service

Set up external agents

Used to configure agents outside your Datalore infrastructure

Enable gift codes

Used to enable a service generating and distributing gift codes

Enable email service

Used to activate email notifications

Enable user activity logging

Used to set up auditing of your Datalore users

Last modified: 09 March 2023