Upgrade with a ZIP Distribution

To upgrade an existing Hub installation:

1. Download the ZIP distribution from the JetBrains website.

2. Stop the Hub service. For specific instructions, see Stop and Restart the Hub Service.

3. Use your operating system tools to verify that all Java processes that are launched by Hub are no longer running. If there are Hub-related Java processes that are still running, interrupt the outstanding process trees .

4. Clear out your <hub_home> directory.

   • For a ZIP installation, the <hub_home> directory is the location where the ZIP distribution was unpacked during installation.

   • For an MSI installation, the <hub_home> directory is %\programdata%\\JetBrains\Hub.

   Do not extract the ZIP installation file to a directory that contains old files.

   We recommend that you perform the following steps:

   • Rename the existing <hub_home> directory to Hub_old (you can use another name).

   • Create a new <hub_home> directory in the same location as the previous installation.

   If you are upgrading an MSI installation, confirm that you have access to the <hub_home> directory and the location that you want to use as the upgrade source.

5. Extract the contents of the ZIP archive to the empty <hub_home> directory.

6. In a command-line interface, enter a command to start the upgrade:

   • If you enter <hub_home>/bin/hub.sh run, the console is blocked until the service is stopped.

   • If you enter <hub_home>/bin/hub.sh start, the console is only blocked during the startup process.

   If you do not have a web browser installed on the host machine, follow the command with the --no-browser option. For example, <hub_home>/bin/hub.sh start --no-browser.

   • If you enter <hub_home>\bin\hub.bat run, the console is blocked until the service is stopped.

   • If you enter <hub_home>\bin\hub.bat start, the console is only blocked during the startup process.

   If you do not have a web browser installed on the host machine, follow the command with the --no-browser option. For example, <hub_home>\bin\hub.bat start --no-browser.

7. Continue with the upgrade installation in the web-based Configuration Wizard.

   • If you have a browser installed on the host machine, the Configuration Wizard opens automatically.

   • If you do not have a web browser installed on the host machine, open the URL of the wizard in a web browser on another workstation. The wizard URL is printed in the console output:

     JetBrains Hub <version> will be available on [<Hub Base URL>/bundle/starting] after start

8. In the Configuration Wizard, click Upgrade.

   

9. On the Select Upgrade Source page, click the Select button and select an upgrade source.

   

   You can select the location of a backup or the location of an existing Hub installation.

10. When done, click Next.

11. On the Confirm Settings page, confirm or change your system settings and the location of system directories.

    

12. When done, click Upgrade.

    • Hub launches its components.

      Do not close the page in the browser until the setup is complete. When the Hub server is ready, you are redirected to the login page.

13. Enter the credentials for the Hub administrator account and click the Log in button.

    • Hub opens to the Users page.

    Your Hub installation is upgraded and ready to use.

To upgrade from a docker image to the ZIP distribution:

1. Create a backup of the Hub database while your existing Hub installation is running.

2. Download the ZIP distribution from the JetBrains website.

3. Stop the Hub docker container.

4. Extract the contents of the ZIP archive to the empty <hub_home> directory.

5. In a command-line interface, enter a command to start the upgrade:

   • If you enter <hub_home>/bin/hub.sh run, the console is blocked until the service is stopped.

   • If you enter <hub_home>/bin/hub.sh start, the console is only blocked during the startup process.

   If you do not have a web browser installed on the host machine, follow the command with the --no-browser option. For example, <hub_home>/bin/hub.sh start --no-browser.

   • If you enter <hub_home>\bin\hub.bat run, the console is blocked until the service is stopped.

   • If you enter <hub_home>\bin\hub.bat start, the console is only blocked during the startup process.

   If you do not have a web browser installed on the host machine, follow the command with the --no-browser option. For example, <hub_home>\bin\hub.bat start --no-browser.

6. Continue with the upgrade installation in the web-based Configuration Wizard.

   • If you have a browser installed on the host machine, the Configuration Wizard opens automatically.

   • If you do not have a web browser installed on the host machine, open the URL of the wizard in a web browser on another workstation. The wizard URL is printed in the console output:

     JetBrains Hub <version> will be available on [<Hub Base URL>/bundle/starting] after start

7. In the Configuration Wizard, click Upgrade.

   

8. On the Select Upgrade Source page, click the Select button and select the created backup file as the upgrade source.

   

   When done, click Next.

9. On the Confirm Settings page, confirm or your system settings and the location of system directories.

   

10. When done, click Upgrade.

    • Hub launches its components.

      Do not close the page in the browser until the setup is complete. When the Hub server is ready, you are redirected to the login page.

11. Enter the credentials for the Hub administrator account and click the Log in button.

    • Hub opens to the Users page.

    Your Hub installation is upgraded and ready to use.

To remove files from a previous ZIP installation:

• Delete the <hub_home> directory that corresponds with the previous installation. If you followed the upgrade instructions provided here, this should now be called Hub_old unless you specifically chose something else.

• If you have any directories that stored application data (like the data and logs folders) that were stored outside the home directory for your installation and are not reused by the upgraded installation, you can safely delete these as well.

  To view the location of the directories that were used by the previous ZIP installation, check the <old_hub_home>/conf/internal/bundle.properties file.

To remove files from a previous MSI installation:

• Use the Windows Control Panel application to uninstall the previous Hub installation.

• Delete any residual folders and files stored in the %\programdata%\\JetBrains\Hub

• If you have any directories that stored application data (like the data and logs folders) that were stored outside the home directory for your installation and are not reused by the upgraded installation, you can safely delete these as well.

  To view the location of the directories that were used by the previous MSI installation, check the %\programdata\\%\JetBrains\YouTrack\conf\internal\bundle.properties file.

To remove files from a previous Docker installation:

• Use the following command to remove the container that was used to run the previous Docker installation:

  docker rm <container_Id>

• If you have any directories on the host machine that were mapped to the old Docker container and are not reused by the upgraded installation, you can safely delete these as well.