# Upgrade Datalore On-Premises (Docker installation) The instructions below explain how to upgrade Datalore On-Premises (Docker installation). The current latest version is 2026.3. > **Note: Important** > * When planning your upgrade to the latest version of Datalore, the upgrade process must be done in a sequential manner. Datalore upgrade mechanism requires you to step through each intermediate version as opposed to skipping straight to the most recent version. This is crucial to ensure the continuity, stability, and integrity of your system and data. We strongly recommend following the correct path from your current version to the desired version, acknowledging each intermediate version in the process. Failure to adhere to this can result in unforeseen compatibility issues, performance inconsistencies or data loss. > > * If you use a custom agent configuration, update agent images so that agent and server versions match after you upgrade Datalore. > > * Back up Docker volumes before updating Datalore. Procedure: Upgrade to version 2026.3 > **Note:** > You should only upgrade to version 2026.3 if the current version is 2026.2 (all patch versions). > > > > To upgrade from an earlier version, apply each intermediate version in order. Skipping versions is not supported and may cause compatibility issues or data loss. 1. [Update Hub](update-hub.html) if your Datalore installation uses it. 2. Update `docker-compose.yaml`: 1. Download and open the `docker-compose.yaml` file from the [datalore-configs repository](https://github.com/JetBrains/datalore-configs/tree/2026.3/docker-compose) on GitHub. 2. Edit the configuration file and add the secrets, environmental variables, and other custom settings you had in the previous version. Procedure: Upgrade to version 2026.2.4 > **Note:** > You should only upgrade to version 2026.2.4 if the current version is 2026.1 or 2026.2 (all patch versions). > > > > To upgrade from an earlier version, apply each intermediate version in order. Skipping versions is not supported and may cause compatibility issues or data loss. 1. [Update Hub](update-hub.html) if your Datalore installation uses it. 2. Update `docker-compose.yaml`: 1. Download and open the `docker-compose.yaml` file from the [datalore-configs repository](https://github.com/JetBrains/datalore-configs/tree/2026.2.4/docker-compose) on GitHub. 2. Edit the configuration file and add the secrets, environmental variables, and other custom settings you had in the previous version. Procedure: Upgrade to version 2026.2.3 > **Note:** > You should only upgrade to version 2026.2.3 if the current version is 2026.1 or 2026.2 (all patch versions). > > > > To upgrade from an earlier version, apply each intermediate version in order. Skipping versions is not supported and may cause compatibility issues or data loss. 1. [Update Hub](update-hub.html) if your Datalore installation uses it. 2. Update `docker-compose.yaml`: 1. Download and open the `docker-compose.yaml` file from the [datalore-configs repository](https://github.com/JetBrains/datalore-configs/tree/2026.2.3/docker-compose) on GitHub. 2. Edit the configuration file and add the secrets, environmental variables, and other custom settings you had in the previous version. Procedure: Upgrade to version 2026.2.2 > **Note:** > You should only upgrade to version 2026.2.2 if the current version is 2026.1 or 2026.2 (all patch versions). > > > > To upgrade from an earlier version, apply each intermediate version in order. Skipping versions is not supported and may cause compatibility issues or data loss. 1. [Update Hub](update-hub.html) if your Datalore installation uses it. 2. Update `docker-compose.yaml`: 1. Download and open the `docker-compose.yaml` file from the [datalore-configs repository](https://github.com/JetBrains/datalore-configs/tree/2026.2.2/docker-compose) on GitHub. 2. Edit the configuration file and add the secrets, environmental variables, and other custom settings you had in the previous version. Procedure: Upgrade to version 2026.2.1 > **Note:** > You should only upgrade to version 2026.2.1 if the current version is 2026.1 (all patch versions). > > > > To upgrade from an earlier version, apply each intermediate version in order. Skipping versions is not supported and may cause compatibility issues or data loss. 1. [Update Hub](update-hub.html) if your Datalore installation uses it. 2. Update `docker-compose.yaml`: 1. Download and open the `docker-compose.yaml` file from the [datalore-configs repository](https://github.com/JetBrains/datalore-configs/tree/2026.2.1/docker-compose) on GitHub. 2. Edit the configuration file and add the secrets, environmental variables, and other custom settings you had in the previous version. Procedure: Upgrade to version 2026.1.1 > **Note:** > You should only upgrade to version 2026.1.1 if the current version is 2025.6 (all patch versions) or 2026.1. > > > > To upgrade from an earlier version, apply each intermediate version in order. Skipping versions is not supported and may cause compatibility issues or data loss. 1. [Update Hub](update-hub.html) if your Datalore installation uses it. 2. Update `docker-compose.yaml`: 1. Download and open the `docker-compose.yaml` file from the [datalore-configs repository](https://github.com/JetBrains/datalore-configs/tree/2026.1.1/docker-compose) on GitHub. 2. Edit the configuration file and add the secrets, environmental variables, and other custom settings you had in the previous version. Procedure: Upgrade to version 2026.1 > **Note:** > You should only upgrade to version 2026.1 if the current version is 2025.6 (all patch versions) or 2026.1. > > > > To upgrade from an earlier version, apply each intermediate version in order. Skipping versions is not supported and may cause compatibility issues or data loss. 1. [Update Hub](update-hub.html) if your Datalore installation uses it. 2. Update `docker-compose.yaml`: 1. Download and open the `docker-compose.yaml` file from the [datalore-configs repository](https://github.com/JetBrains/datalore-configs/tree/2026.1/docker-compose) on GitHub. 2. Edit the configuration file and add the secrets, environmental variables, and other custom settings you had in the previous version. Procedure: Upgrade to version 2025.6.2 > **Note:** > You should only upgrade to version 2025.6.2 if the current version is 2025.5, 2025.5.1, 2025.6, or 2025.6.1. > > > > To upgrade from an earlier version, apply each intermediate version in order. Skipping versions is not supported and may cause compatibility issues or data loss. 1. [Update Hub](update-hub.html) if your Datalore installation uses it. 2. Update `docker-compose.yaml`: 1. Download and open the `docker-compose.yaml` file from the [datalore-configs repository](https://github.com/JetBrains/datalore-configs/tree/2025.6.2/docker-compose) on GitHub. 2. Edit the configuration file and add the secrets, environmental variables, and other custom settings you had in the previous version. Procedure: Upgrade to version 2025.6.1 > **Note:** > You should only upgrade to version 2025.6.1 if the current version is 2025.5, 2025.5.1, or 2025.6. > > > > To upgrade from an earlier version, apply each intermediate version in order. Skipping versions is not supported and may cause compatibility issues or data loss. 1. [Update Hub](update-hub.html) if your Datalore installation uses it. 2. Update `docker-compose.yaml`: 1. Download and open the `docker-compose.yaml` file from the [datalore-configs repository](https://github.com/JetBrains/datalore-configs/tree/2025.6.1/docker-compose) on GitHub. 2. Edit the configuration file and add the secrets, environmental variables, and other custom settings you had in the previous version. Procedure: Upgrade to version 2025.6 > **Note:** > You should only upgrade to version 2025.6 if the current version is 2025.5 or 2025.5.1. > > > > To upgrade from an earlier version, apply each intermediate version in order. Skipping versions is not supported and may cause compatibility issues or data loss. 1. [Update Hub](update-hub.html) if your Datalore installation uses it. 2. Update `docker-compose.yaml`: 1. Download and open the `docker-compose.yaml` file from the [datalore-configs repository](https://github.com/JetBrains/datalore-configs/tree/2025.6/docker-compose) on GitHub. 2. Edit the configuration file and add the secrets, environmental variables, and other custom settings you had in the previous version. Procedure: Upgrade to version 2025.5.1 > **Note:** > You should only upgrade to version 2025.5.1 if the current version is 2025.4, 2025.4.1, or 2025.5. > > > > To upgrade from an earlier version, apply each intermediate version in order. Skipping versions is not supported and may cause compatibility issues or data loss. 1. [Update Hub](update-hub.html) if your Datalore installation uses it. 2. Update `docker-compose.yaml`: 1. Download and open the `docker-compose.yaml` file from the [datalore-configs repository](https://github.com/JetBrains/datalore-configs/tree/2025.5.1/docker-compose) on GitHub. 2. Edit the configuration file and add the secrets, environmental variables, and other custom settings you had in the previous version. Procedure: Upgrade to version 2025.5 > **Note:** > You should only upgrade to version 2025.5 if the current version is 2025.4 or 2025.4.1. > > > > To upgrade from an earlier version, apply each intermediate version in order. Skipping versions is not supported and may cause compatibility issues or data loss. 1. [Update Hub](update-hub.html) if your Datalore installation uses it. 2. Update `docker-compose.yaml`: 1. Download and open the `docker-compose.yaml` file from the [datalore-configs repository](https://github.com/JetBrains/datalore-configs/tree/2025.5/docker-compose) on GitHub. 2. Edit the configuration file and add the secrets, environmental variables, and other custom settings you had in the previous version. 3. Run `docker compose down` and then `docker compose up` to restart Datalore On-Premises. Procedure: Upgrade to version 2025.4.1 > **Note:** > You should only upgrade to version 2025.4.1 if the current version is 2025.3.1 or 2025.4. > > > > To upgrade from an earlier version, apply each intermediate version in order. Skipping versions is not supported and may cause compatibility issues or data loss. 1. [Update Hub](update-hub.html) if your Datalore installation uses it. 2. Update `docker-compose.yaml`: 1. Download and open the `docker-compose.yaml` file from the [datalore-configs repository](https://github.com/JetBrains/datalore-configs/tree/2025.4.1/docker-compose) on GitHub. 2. Edit the configuration file and add the secrets, environmental variables, and other custom settings you had in the previous version. 3. Run `docker compose down` and then `docker compose up` to restart Datalore On-Premises. Procedure: Upgrade to version 2025.4 > **Note:** > You should only upgrade to version 2025.4 if the current version is 2025.3.1. To upgrade from an earlier version, apply each intermediate version in order. Skipping versions is not supported and may cause compatibility issues or data loss. 1. [Update Hub](update-hub.html) if your Datalore installation uses it. 2. Update `docker-compose.yaml`: 1. Download and open the `docker-compose.yaml` file from the [datalore-configs repository](https://github.com/JetBrains/datalore-configs/tree/2025.4/docker-compose) on GitHub. 2. Edit the configuration file and add the secrets, environmental variables, and other custom settings you had in the previous version. 3. Run `docker compose down` and then `docker compose up` to restart Datalore On-Premises. Procedure: Upgrade to version 2025.3.1 > **Note:** > You should only upgrade to version 2025.3.1 if the current version is 2025.2. To upgrade from an earlier version, apply each intermediate version in order. Skipping versions is not supported and may cause compatibility issues or data loss. > **Warning:** > The baseline Python interpreter in 2025.3.1 has been updated to Python 3.11. 1. [Update Hub](update-hub.html) if your Datalore installation uses it. 2. Update `docker-compose.yaml`: 1. Download and open the `docker-compose.yaml` file from the [datalore-configs repository](https://github.com/JetBrains/datalore-configs/tree/2025.3/docker-compose) on GitHub. 2. Edit the configuration file and add the secrets, environmental variables, and other custom settings you had in the previous version. 3. Run `docker compose down` and then `docker compose up` to restart Datalore On-Premises. Procedure: Upgrade to version 2025.2 1. [Update Hub](update-hub.html) if your Datalore installation uses it. 2. Update `docker-compose.yaml`: 1. Download and open the `docker-compose.yaml` file from the [datalore-configs repository](https://github.com/JetBrains/datalore-configs/tree/2025.2/docker-compose) on GitHub. 2. Edit the configuration file and add the secrets, environmental variables, and other custom settings you had in the previous version. 3. Run `docker compose down` and then `docker compose up` to restart the service. Procedure: Upgrade to version 2025.1 1. (Optional) If you're still using secrets and notebook-level SSH keys or Git repositories, make sure to migrate those that you want to keep. Follow [this procedure](migrate-from-deprecated-features.html). 2. [Update Hub](update-hub.html) if your Datalore installation uses it. 3. Update `docker-compose.yaml`: 1. Download and open the `docker-compose.yaml` file from the [datalore-configs repository](https://github.com/JetBrains/datalore-configs/tree/2025.1/docker-compose) on GitHub. 2. Edit the configuration file and add the secrets, environmental variables, and other custom settings you had in the previous version. 4. Run `docker compose down` and then `docker compose up` to restart the service. Procedure: Upgrade to version 2024.5.1 1. (Optional) Make sure you have migrated from [deprecated features](migrate-from-deprecated-features.html). 2. [Update Hub](update-hub.html) if your Datalore installation uses it. 3. Update `docker-compose.yaml`: 1. Download and open the `docker-compose.yaml` file from the [datalore-configs repository](https://github.com/JetBrains/datalore-configs/tree/2024.5.1/docker-compose) on GitHub. 2. Edit the configuration file and add the secrets, environmental variables, and other custom settings you had in the previous version. 4. Run `docker compose down` and then `docker compose up` to restart the service. Procedure: Upgrade to version 2024.5 1. (Optional) Make sure you have migrated from [deprecated features](migrate-from-deprecated-features.html). 2. [Update Hub](update-hub.html) if your Datalore installation uses it. 3. Update `docker-compose.yaml`: 1. Download and open the `docker-compose.yaml` file from the [datalore-configs repository](https://github.com/JetBrains/datalore-configs/tree/2024.5/docker-compose) on GitHub. 2. Edit the configuration file and add the secrets, environmental variables, and other custom settings you had in the previous version. 4. Run `docker compose down` and then `docker compose up` to restart the service. Procedure: Upgrade to version 2024.4.1 1. [Update Hub](update-hub.html) if your Datalore installation uses it. 2. Update `docker-compose.yaml`: 1. Download and open the `docker-compose.yaml` file from the [datalore-configs repository](https://github.com/JetBrains/datalore-configs/tree/2024.4.1/docker-compose) on GitHub. 2. Edit the configuration file and add the secrets, environmental variables, and other custom settings you had in the previous version. 3. Run `docker compose down` and then `docker compose up` to restart the service. Procedure: Upgrade to version 2024.4 > **Warning:** > This version includes PostgreSQL version migration from Postgres 12 to Postgres 15. > > > > If your Datalore installation uses an external database (not the one shipped with Datalore), we advise to upgrade the database instance using the database provider preferred tooling, or to reach out to your database administrator for further guidance. 1. [Update Hub](update-hub.html) if your Datalore installation uses it. 2. Update `docker-compose.yaml`: 1. Download and open the `docker-compose.yaml` file from the [datalore-configs repository](https://github.com/JetBrains/datalore-configs/tree/2024.4/docker-compose) on GitHub. 2. Edit the configuration file and add the secrets, environmental variables, and other custom settings you had in the previous version. 3. Run `docker compose down` and then `docker compose up` to restart the service. Procedure: Upgrade to version 2024.3 1. [Update Hub](update-hub.html) if your Datalore installation uses it. 2. Update `docker-compose.yaml`: 1. Download and open the `docker-compose.yaml` file from the [datalore-configs repository](https://github.com/JetBrains/datalore-configs/tree/2024.3/docker-compose) on GitHub. 2. Edit the configuration file and add the secrets, environmental variables, and other custom settings you had in the previous version. 3. Run `docker compose down` and then `docker compose up` to restart the service. Procedure: Upgrade to version 2024.2.3 1. [Update Hub](update-hub.html) if your Datalore installation uses it. 2. Update `docker-compose.yaml`: 1. Download and open the `docker-compose.yaml` file from the [datalore-configs repository](https://github.com/JetBrains/datalore-configs/tree/2024.2.3/docker-compose) on GitHub. 2. Edit the configuration file and add the secrets, environmental variables, and other custom settings you had in the previous version. 3. Run `docker compose down` and then `docker compose up` to restart the service. Procedure: Upgrade to version 2024.2.2 1. [Update Hub](update-hub.html) if your Datalore installation uses it. 2. Update `docker-compose.yaml`: 1. Download and open the `docker-compose.yaml` file from the [datalore-configs repository](https://github.com/JetBrains/datalore-configs/tree/2024.2.2/docker-compose) on GitHub. 2. Edit the configuration file and add the secrets, environmental variables, and other custom settings you had in the previous version. 3. Run `docker compose down` and then `docker compose up` to restart the service. Procedure: Upgrade to version 2024.2.1 1. [Update Hub](update-hub.html) if your Datalore installation uses it. 2. Update `docker-compose.yaml`: 1. Download and open the `docker-compose.yaml` file from the [datalore-configs repository](https://github.com/JetBrains/datalore-configs/tree/2024.2.1/docker-compose) on GitHub. 2. Edit the configuration file and add the secrets, environmental variables, and other custom settings you had in the previous version. Procedure: Upgrade to version 2024.2 1. [Update Hub](update-hub.html) if your Datalore installation uses it. 2. Update `docker-compose.yaml`: 1. Download and open the `docker-compose.yaml` file from the [datalore-configs repository](https://github.com/JetBrains/datalore-configs/tree/2024.2/docker-compose) on GitHub. 2. Edit the configuration file and add the secrets, environmental variables, and other custom settings you had in the previous version. 3. Run `docker compose down` and then `docker compose up` to restart the service. Procedure: Upgrade to version 2024.1 1. [Update Hub](update-hub.html) if your Datalore installation uses it. 2. Update `docker-compose.yaml`: 1. Download and open the `docker-compose.yaml` file from the [datalore-configs repository](https://github.com/JetBrains/datalore-configs/tree/2024.1/docker-compose) on GitHub. 2. Edit the configuration file and add the secrets, environmental variables, and other custom settings you had in the previous version. 3. Run `docker compose down` and then `docker compose up` to restart the service. Procedure: Check content output migration Upgrade to 2024.1 involves an internal output migration. We strongly recommend that you check whether the migration went successfully and report any discovered errors if such occurred in the process. which we strongly recommend checking by performing the following steps. 1. When running the updated version (2024.1) for the first time, check Datalore server logs. The logs are expected to contain lines similar to the ones in the example below. > **Note:** > Timings, thread names and number of files presented in the example will differ from yours. ``` 12:44:03.931 INFO [OutputsMigrationEDT] j.d.o.s.i.migration.OutputsMigrationTool Files to migrate: 313
 12:44:04.205 INFO [Thread-3] j.d.o.s.i.m.LoggingOutputMigrationProgressTracker Processed 4/313 (1%) file(s) 12:44:04.261 INFO [Thread-2] j.d.o.s.i.m.LoggingOutputMigrationProgressTracker Processed 7/313 (2%) file(s) ... 12:44:05.324 INFO [Thread-3] j.d.o.s.i.m.LoggingOutputMigrationProgressTracker Processed 313/313 (100%) file(s) ``` 2. Check if there were any errors that occurred during the migration. Such errors will be listed as a short summary below the `Processed [n] 100% files` line. If no errors are found, no further steps need to be performed. 3. If there are any errors, save the IDs of notebooks together with the error messages. Scroll up the logs and find and save the respective stacktraces for these errors. 4. Use the saved IDs to try to open the notebooks with the migration errors. If any of these notebooks fail to open, contact Datalore support providing the error message and stacktrace for each such notebook. Procedure: Upgrade to version 2023.6 1. [Update Hub](update-hub.html) if your Datalore installation uses it. 2. Update `docker-compose.yaml`: 1. Download and open the `docker-compose.yaml` file from the [datalore-configs repository](https://github.com/JetBrains/datalore-configs/tree/2023.6/docker-compose) on GitHub. 2. Edit the configuration file and add the secrets, environmental variables, and other custom settings you had in the previous version. 3. Run `docker compose down` and then `docker compose up` to restart the service. Procedure: Upgrade to version 2023.5.1 1. [Update Hub](update-hub.html) if your Datalore installation uses it. 2. Update `docker-compose.yaml`: 1. Download and open the `docker-compose.yaml` file from the [datalore-configs repository](https://github.com/JetBrains/datalore-configs/tree/2023.5.1/docker-compose) on GitHub. 2. Edit the configuration file and add the secrets, environmental variables, and other custom settings you had in the previous version. 3. Run `docker compose down` and then `docker compose up` to restart the service. Procedure: Upgrade to version 2023.5 1. [Update Hub](update-hub.html) if your Datalore installation uses it. 2. Update `docker-compose.yaml`: 1. Download and open the `docker-compose.yaml` file from the [datalore-configs repository](https://github.com/JetBrains/datalore-configs/tree/2023.5/docker-compose) on GitHub. 2. Edit the configuration file and add the secrets, environmental variables, and other custom settings you had in the previous version. 3. Run `docker compose down` and then `docker compose up` to restart the service. Procedure: Upgrade to version 2023.4 1. [Update Hub](update-hub.html) if your Datalore installation uses it. 2. Update `docker-compose.yaml`: 1. Download and open the `docker-compose.yaml` file from the [datalore-configs repository](https://github.com/JetBrains/datalore-configs/tree/2023.4/docker-compose) on GitHub. 2. Edit the configuration file and add the secrets, environmental variables, and other custom settings you had in the previous version. 3. Run `docker compose down` and then `docker compose up` to restart the service. Procedure: Upgrade to version 2023.3.1 1. [Update Hub](update-hub.html) if your Datalore installation uses it. 2. Update `docker-compose.yaml`: 1. Download and open the `docker-compose.yaml` file from the [datalore-configs repository](https://github.com/JetBrains/datalore-configs/tree/2023.3.1/docker-compose) on GitHub. 2. Edit the configuration file and add the secrets, environmental variables, and other custom settings you had in the previous version. 3. Run `docker compose down` and then `docker compose up` to restart the service. > **Note:** > The updating procedure involves checkpoint migration, which will cause the first startup of the new version to take longer than usual. Procedure: Upgrade to version 2023.2 1. [Update Hub](update-hub.html) if your Datalore installation uses it. 2. Update `docker-compose.yaml`: 1. Download and open the `docker-compose.yaml` file from the [datalore-configs repository](https://github.com/JetBrains/datalore-configs/tree/2023.2/docker-compose) on GitHub. 2. Edit the configuration file and add the secrets, environmental variables, and other custom settings you had in the previous version. 3. Run `docker compose down` and then `docker compose up` to restart the service. > **Note:** > The updating procedure involves checkpoint migration, which will cause the first startup of the new version to take longer than usual. Procedure: Upgrade to version 2023.1 1. [Update Hub](update-hub.html) if your Datalore installation uses it. 2. Update `docker-compose.yaml`: 1. Download and open the `docker-compose.yaml` file from the [datalore-configs repository](https://github.com/JetBrains/datalore-configs/tree/2023.1/docker-compose) on GitHub. 2. Edit the configuration file and add the secrets, environmental variables, and other custom settings you had in the previous version. 3. Run `docker compose down` and then `docker compose up` to restart the service. Procedure: Upgrade to version 2022.3.1 1. [Update Hub](update-hub.html) if your Datalore installation uses it. 2. Update `docker-compose.yaml`: 1. Download and open the `docker-compose.yaml` file from the [datalore-configs repository](https://github.com/JetBrains/datalore-configs/tree/2022.3.1/docker-compose) on GitHub. 2. Edit the configuration file and add the secrets, environmental variables, and other custom settings you had in the previous version. 3. Run `docker compose stop` and then `docker compose start` to restart the service. Procedure: Upgrade from 2022.2-2022.2.2 to 2022.2.3 1. [Update Hub](update-hub.html) if your Datalore installation uses it. 2. Update `docker-compose.yaml`. 3. Run `docker compose restart` to restart the service.