You can use the ZIP distribution to upgrade an existing Hub installation of any type.
Prerequisites
Before you upgrade, 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.
Upgrade a ZIP or MSI Installation
Whether your Hub service was previously installed using a ZIP or an MSI distribution, you can use the ZIP distribution to upgrade to the latest version of Hub.
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, kill the outstanding process trees.
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.
Extract the contents of the ZIP archive to the empty <hub_home> directory.
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.
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:
Extract the contents of the ZIP archive to the empty <hub_home> directory.
In a command-line interface, enter the following command to start Hub: <hub_home>/bin/hub.sh run
If you do not have a web browser installed on the host machine, enter ./hub.sh run --no-browser.
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: