Hub 2.0 Help

Configure System Properties

System properties in Hub are the basic settings for your Hub server. Many system properties are defined when you install or upgrade Hub. Others are defined in the user interface, for example, on the System Settings page.

The best way to manage the following system properties for your Hub server is to set the desired values in the user interface. Use the links in the Location column to learn where you can update these settings in Hub.

PropertyDescriptionTypeLocation
jetbrains.jetpass.locale Sets the language displayed in the Hub user interface. Specify the language in IETF BCP 47 format (en-US, de-DE, es-ES, fr-FR, ru-RU).stringSystem Settings
jetbrains.jetpass.motto.disabled Disables the Hub Motto on the user interface.BooleanSystem Settings
jetbrains.jetpass.smtp.enable Enables or disables email notifications.BooleanSystem Settings
jetbrains.jetpass.smtp.host Sets the SMTP host address.stringSystem Settings
jetbrains.jetpass.smtp.port Sets the SMTP connection port.integerSystem Settings
jetbrains.jetpass.smtp.protocol Sets the protocol that is used to send email notifications. Supports the following values: SMTP / SMTP+SSL / SMTP+TLSstringSystem Settings
jetbrains.jetpass.smtp.from Sets the email address that is used as the "From:" field in email notifications.stringSystem Settings
jetbrains.jetpass.smtp.login Sets the login for the account that is used for authentication by the SMTP server.stringSystem Settings
jetbrains.jetpass.smtp.password Sets the password for the account that is used for authentication by the SMTP server.stringSystem Settings
jetbrains.jetpass.jabber.enable Enables or disables notifications over Jabber.BooleanSystem Settings
jetbrains.jetpass.jabber.server Sets the address of the Jabber service.stringSystem Settings
jetbrains.jetpass.jabber.port Sets the connection port for the Jabber service.integerSystem Settings
jetbrains.jetpass.jabber.service.name Sets the name of the Jabber service.stringSystem Settings
jetbrains.jetpass.jabber.sasl.enable Enables or disables SASL authentication for the Jabber service.BooleanSystem Settings
jetbrains.jetpass.jabber.login Sets the login for the account that is used for authentication by the Jabber service.stringSystem Settings
jetbrains.jetpass.jabber.password Sets the password for the account that is used for authentication by the Jabber service.stringSystem Settings
jetbrains.jetpass.license.name Sets the name for the Hub service license.stringLicenses
jetbrains.jetpass.license.key Sets the license key for the Hub service license.stringLicenses
jetbrains.jetpass.database.backup.location Sets the directory where Hub stores database backup files.stringBackup

Configure System Properties from the Command Line

Hub stores system properties in and JVM options in an internal configuration file. Every time you start the Hub service, Hub reads this file and applies this configuration to the Hub database.

The one-way synchronization from the configuration file to the database can lead to problems if you're not careful. System properties that are set in the Hub user interface are applied directly to the Hub database. If you change a setting in the user interface that has been updated in the configuration file, the setting in the configuration file is applied to the database on restart, overwriting the setting in the UI.

To avoid conflicts, we recommend that you update and manage these settings in the user interface. This ensures that you don't have synchronization issues with the configuration file.

You can update a system parameter in a command-line interface. In this case, you pass the system property to Hub as an ad hoc parameter with the start command. This method updates the settings in the database without applying changes to the configuration file. Your database remains in sync with the settings in the user interface.

These commands are available for both MSI and ZIP installations. To execute these commands in an MSI distribution, open the Command Prompt window as an administrator.

To pass a system property as an ad hoc parameter:

  1. Stop the Hub service.
  2. In a command-line interface, change the directory to <hub_home>/bin.
    • For a ZIP installation, the <hub_home>/bin directory is the location where the ZIP distribution was unpacked during installation.
    • For an MSI installation, the <hub_home>/bin directory is the location where the MSI distribution was installed. The default installation directory is C:\Hub
  3. Enter the hub.sh startcommand, followed by all of the system properties that you want to pass to the Hub database on start.
    • Use the --J prefix to pass the settings as ad hoc parameters.
    • Set the system properties in the format -Dproperty=value. Do not add any spaces between the prefix and the system property.
    For example:
    hub.sh start --J-Djetbrains.jetpass.smtp.host=mail.myserver.com --J-Djetbrains.jetpass.smtp.port=110
    • The Hub service starts using the specified settings.
    • The system property is stored in the Hub database.
    • The hub.jvmoptions file is not modified.
Last modified: 19 September 2016