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.
| Property | Description | Type | Location |
|---|---|---|---|
jetbrains.hub.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). | string | System Settings |
jetbrains.hub.motto.disabled | Disables the Hub Motto on the user interface. Default value: false | Boolean | System Settings |
jetbrains.hub.smtp.enable | Enables or disables email notifications. Default value: false | Boolean | System Settings |
jetbrains.hub.smtp.host | Sets the SMTP host address. | string | System Settings |
jetbrains.hub.smtp.port | Sets the SMTP connection port. | integer | System Settings |
jetbrains.hub.smtp.protocol | Sets the protocol that is used to send email notifications. Supports the following values: SMTP / SMTP+SSL / SMTP+TLS | string | System Settings |
jetbrains.hub.smtp.from | Sets the email address that is used as the "From:" field in email notifications. | string | System Settings |
jetbrains.hub.smtp.login | Sets the login for the account that is used for authentication by the SMTP server. | string | System Settings |
jetbrains.hub.smtp.password | Sets the password for the account that is used for authentication by the SMTP server. | string | System Settings |
jetbrains.hub.jabber.enable | Enables or disables notifications over Jabber. Default value: false | Boolean | System Settings |
jetbrains.hub.jabber.server | Sets the address of the Jabber service. | string | System Settings |
jetbrains.hub.jabber.port | Sets the connection port for the Jabber service. | integer | System Settings |
jetbrains.hub.jabber.service.name | Sets the name of the Jabber service. | string | System Settings |
jetbrains.hub.jabber.sasl.enable | Enables or disables SASL authentication for the Jabber service. Default value: false | Boolean | System Settings |
jetbrains.hub.jabber.login | Sets the login for the account that is used for authentication by the Jabber service. | string | System Settings |
jetbrains.hub.jabber.password | Sets the password for the account that is used for authentication by the Jabber service. | string | System Settings |
jetbrains.hub.license.name | Sets the name for the Hub service license. | string | Licenses |
jetbrains.hub.license.key | Sets the license key for the Hub service license. | string | Licenses |
jetbrains.hub.database.backup.location | Sets the directory where Hub stores database backup files. | string | Backup |
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:
- Stop the Hub service.
- In a command-line interface, change the directory to
<hub_home>/bin. - 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
--Jprefix 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.
hub.sh start --J-Djetbrains.hub.smtp.host=mail.myserver.com --J-Djetbrains.hub.smtp.port=110 - Use the