ZIP Installation

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 a command to start the installation:

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

   • If you enter ./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.sh start --no-browser.

5. Continue with the 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

6. In the Configuration Wizard, click Set up.

   

7. On the Confirm Settings page, confirm or change the basic system settings.

   

   Here you can also enable the built-in TLS to secure the network connection for the server. For detailed procedure, read the Enable HTTPS during Installation page.

   Setting	Description
   HTTP | HTTPS	Allows to enable or disable the built-in TLS and configure the secure the network connection to your server. If you enable HTTPS, the TLS specific settings are displayed. See the TLS Attributes page for details.
   Base URL	The URL where end users access Hub.
   Application Listen Port	The port your Hub server listens to after installation.
   Language	The default language that is shown in the user interface.

8. Expand the Advanced Settings section to confirm or change the locations where Hub stores product data.

   

   Setting	Description
   Data Directory Location	The directory where Hub stores content data.
   Backup Location	The directory where Hub stores backups of the database.
   Logs Location	The directory where Hub stores log files.
   Temp Location	The 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.

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

10. When done, click Next.

11. On the Configure Hub Service page, enter and confirm the password for the system administrator account. The default username is admin.

    

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

    Optionally, deselect the Enable login as guest option to ban the guest user account .

12. When done, click Next.

13. On the Confirm License page, verify the license name and key.

    

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

    • If you disabled guest user account, you are redirected to the login page.

    • If you enabled guest user account, you are redirected to the Dashboard.