Upgrade Hub

Prerequisites

Before you upgrade, perform the following prerequisite tasks:

Create a backup of your current database. Hub does not provide forward database compatibility. Your database is migrated to the format that is compatible with the latest version during the upgrade procedure. This means that you cannot revert to a previous version and continue to use the database that was processed during the upgrade.
Copy the backup of your current database to a secure location just in case you encounter problems with the upgrade and need to roll back to the previous version.

Recommended upgrade path

Assuming that your Hub values file is hub.values.yaml, run the command below to upgrade Hub.
helm upgrade -f hub.values.yaml hub datalore/hub --version 0.2.26
Run the kubectl logs service/hub to check the Hub output for wizard_token.
The expected output has a line like this:
JetBrains Hub 2024.3 Configuration Wizard will be available on [http://[host_name]:8082/?wizard_token=aDeMLUMskcpZW4sXJQye] after start
Copy the wizard_token value to the clipboard.
Open the Hub page in your browser and insert the wizard_token value into the Token field.
Click the Log in button.
Click the Upgrade button and wait for the upgrade to complete.

Make sure you have the Hub version updated in your docker-compose.yaml. Refer to the example below:
services: ... hub: image: jetbrains/hub:2024.3.56671
Run docker compose down to stop Datalore.
Run docker compose up hub to start the Hub service.
Check the Docker output for wizard_token. Use the docker compose logs hub command if running in the detached mode.
The expected output has a line like this:
JetBrains Hub 2024.3 Configuration Wizard will be available on [http://[host_name]:8082/?wizard_token=aDeMLUMskcpZW4sXJQye] after start
Copy the wizard_token value to the clipboard.
Open the Hub page in your browser and insert the wizard_token value into the Token field.
Click the Log in button.
Click the Upgrade button and wait for the upgrade to complete.
Run docker compose up to start Datalore.

Last modified: 28 January 2025