Hub 2017.2 Help

MSI Installation

The Hub MSI distribution is available for download on the JetBrains website.

The following software is bundled with the Hub MSI distribution:

  • Jetty servlet engine and HTTP server
  • Java SE Runtime Environment 8 x64

The MSI distribution does not include JRE x86. If you want to install Hub in an x86 environment, you will need to download and install the Java Runtime Environment that is compatible with your operating system.

The MSI installer requires .NET Framework version 2.0 or later.

To install Hub as a Windows service:

  1. Download the MSI distribution from the JetBrains website.
  2. Open the Windows Installer Package (MSI file).
    • The JetBrains Hub Setup Wizard opens.
    /help/img/hub/2017.2/hub-setup-wizard-setup.png
  3. Follow the instructions in the setup wizard.
    • When the setup wizard is finished, the web-based Configuration Wizard opens in your default browser.

      If you do not have a web browser installed on the host machine, open the URL that is provided by the setup wizard in a web browser on another workstation.

  4. In the Configuration Wizard, click Set up.
    /help/img/hub/2017.2/installHubSetup_thumbnail.png
  5. On the Confirm Settings page, confirm or change the basic system settings.
    /help/img/hub/2017.2/installHubConfirmSettings_thumbnail.png
    SettingDescription
    Base URLThe URL where end users access Hub.
    Application Listen PortThe port your Hub server listens to after installation.
    LanguageThe default language that is shown in the user interface.
  6. Expand the Advanced Settings section to confirm or change the locations where Hub stores product data.
    /help/img/hub/2017.2/installHubAdvancedSettings_thumbnail.png
    SettingDescription
    Data Directory LocationThe directory where Hub stores content data.
    Backup LocationThe directory where Hub stores backups of the database.
    Logs LocationThe directory where Hub stores log files.
    Temp LocationThe directory where Hub stores product-specific temporary files.

    To change the location for any of these file types, click the Change button and select a new location.

  7. To share usage statistics with Jetbrains, keep the Send usage statistics anonymously option enabled. This feature helps JetBrains track usage statistics to make Hub better. We never share collected data with any third party.
  8. When done, click Next.
  9. On the Select Hub Service page, enter and confirm the password for the system administrator account. The default username is admin.
    /help/img/hub/2017.2/installHubService_thumbnail.png

    To assign a different username to the administrator account, edit the Create Admin Login setting.

    Deselect the Enable login as guest option to ban the guest user account.

  10. When done, click Next.
  11. On the Confirm License page, verify the license name and key.
    /help/img/hub/2017.2/InstallHubLicense_thumbnail.png
  12. When done, click Finish.
    • The configuration is applied to your Hub server.

    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 administrator account that you created during the configuration and click the Log in button.
    • Hub opens to the Users page.

    That's it. Your Hub instance is installed and ready for use.

Previous Installation Data Found

During installation, the Setup Wizard can detect data from a previous installation of Hub. These files may be left over from an installation that was uninstalled or installed by another user.

You can choose from the following options to proceed with the installation:

  • Perform a clean installation.
  • Install Hub using configuration files and data left from the previous installation.

Unless you are familiar with the details of the previous installation, we recommend that you perform a clean installation. The files from the previously installed version will be removed.

Last modified: 19 July 2017