Hub 2017.1 Help

ZIP Installation

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

The Hub ZIP is a cross-platform distribution. You can use this distribution to install and run Hub on Linux, OS X, and Windows.

The procedure for installing Hub with this distribution is similar for all operating systems. All you need to do is select the appropriate application and run the script that is supported by your operating system.

Operating SystemApplicationScript
LinuxCommand Line Interfacehub.sh
OS XTerminalhub.sh
WindowsCommand Prompthub.bat

To install Hub with a ZIP distribution:

  1. Download the ZIP distribution from the JetBrains website.
  2. Create a directory on your server to use as the home directory for Hub. Extract the files from the ZIP archive and select this directory as the destination folder.
  3. In a command-line interface, change the directory to <Hub home directory>/bin.
  4. Enter the command ./hub.sh run.

    If you do not have a web browser installed on the host machine, enter ./hub.sh run --no-browser.

    • The web-based Configuration Wizard opens in your default browser. The wizard helps you set up and start your new Hub server.

      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 2.0 will be available on [<Hub Base URL>/bundle/starting] after start

  5. In the Configuration Wizard, click Set up.
  6. On the Confirm Settings page, confirm or change the basic system settings.
    /help/img/hub/2017.1/hubInstallConfirmSettings.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.
  7. Expand the Advanced Settings section to confirm or change the locations where Hub stores product data.
    /help/img/hub/2017.1/hubInstallConfirmSettingsAdvanced.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.

  8. 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.
  9. When done, click Next.
  10. 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.1/hubInstallServiceSettings.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.

  11. When done, click Next.
  12. On the Confirm License page, verify the license name and key.
    /help/img/hub/2017.1/hubInstallConfirmLicense.png
  13. 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.

  14. 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.

See Also

Last modified: 6 April 2017