YouTrack Standalone 2017.3 Help

Configuration Parameters

The following list includes all of the YouTrack-specific Java start parameters.

To learn how to apply these parameters when you start YouTrack, see Configure JVM Options.

General Parameters

You can set the following parameters for any YouTrack installation.

Parameter

Data Type

Default Value

Description

root.email

email address

empty

Changes the current email address that is set for the root user account.

root.jabber

Jabber account

empty

Changes the current Jabber account that is set for the root account.

jetbrains.charisma.restoreRootPassword

Boolean

false

Restores the password for the root user account to the default value root.

jetbrains.youtrack.support.email

email address

youtrack-feedback@jetbrains.com

Specifies the email address that is used as the mailto address for the Contact support link on the error screen.

jetbrains.youtrack.overrideRootPassword

string

empty

Sets a new password for the root user account.

jetbrains.youtrack.disableCheckForUpdate

Boolean

false

Enables and disables checking for software updates on startup. When set to true, checking for software updates is disabled.

jetbrains.youtrack.workflow.detachModified

Boolean

false

Detaches all workflow rules from projects except for the default workflows that have not been modified in any way.

jetbrains.dnq.textIndex.minPrefixQueryLength

integer

3

Sets the minimum length of a prefix query string to a set number of characters. If prefix queries and wildcard strings do not return all matching word forms in a search query, set this value to 2. Setting this system property affects the performance of your YouTrack server. The lower the value, the slower the performance of your server.

jetbrains.youtrack.mailLimit

integer

0

Sets a daily limit for the number of email messages that are sent with the issue.sendMail() method in workflows. When set to 0, there is no limit. The default value for YouTrack InCloud instances is 100.

jetbrains.youtrack.default.page

string

/dashboard

Sets the default start page for your YouTrack server. Enter a relative path to your base URL with a leading slash.

Authentication Throttling Parameters

The following JVM options let you configure how rate limits are applied to failed authentication requests. To protect the security of your application, the default values for these settings are undisclosed.

Parameter

Data Type

Description

jetbrains.hub.auth.login.throttling.enabled

Boolean

Sets the status of the throttling feature for the Hub authentication module. When true, authentication throttling is enabled.

jetbrains.hub.auth.login.throttling.size

integer

Sets the maximum number of IP addresses that are tracked for rate limiting.

jetbrains.hub.auth.login.throttling.failures

integer

Sets the maximum number of consecutive failed requests that are allowed before rate limitations are applied to incoming requests from the tracked IP address.

jetbrains.hub.auth.login.throttling.cooldown-value

integer

Sets the number of entries that are removed from the counter for each IP address at the interval that is specified for the cooldown period.

jetbrains.hub.auth.login.throttling.cooldown-period-sec

integer

Sets the interval at which entries are removed from the counter for each IP address, in seconds.

jetbrains.hub.auth.login.throttling.white-list

comma-delimited string

Defines the list of IP addresses that are not tracked for failed login requests.

Proxy Server Parameters

The following JVM options let YouTrack connect with third-party services through a proxy server:

Property

Description

http.proxyHost

The host name of your proxy server.

http.proxyPort

The port number that the proxy server listens to.

https.proxyHost

The host name of your secure proxy server.

https.proxyPort

The port number that the secure proxy server listens to.

http.nonProxyHosts

A list of hosts that YouTrack accesses directly, bypassing the proxy server.
  • Delimit multiple hosts with a vertical bar.

  • Use the asterisk as a wildcard character to specify a pattern.

The list of non-proxy hosts can be used with both HTTP and HTTPS protocols. If this property is not set, all traffic is routed through the proxy server.

JAR Installation Parameters

The following parameters are only applicable to a YouTrack JAR installation.

Parameter

Data Type

Default Value

Description

database.location

path

~/teamsysdata

Specifies the location of the YouTrack database. You can use this parameter to change the default database location. For more information, see Change Database Location.

database.backup.location

path

~/teamsysdata-backup

Specifies the folder to which database backups are saved. You can use this parameter to override the database backup location that is set in the user interface. For more information, see Back Up the Database.

jetbrains.youtrack.baseUrl

URL

Derived from the server network name

Sets the baseURL of your YouTrack instance. For more information, see System.

jetbrains.youtrack.disableBrowser

Boolean

false

Enables or disables opening YouTrack in a web browser when the service starts. When set to true, YouTrack does not open a web browser on startup.

jetbrains.youtrack.licenseName

string

YouTrack free license name

Sets the name of the license agreement.

jetbrains.youtrack.licenseKey

string

YouTrack free license key

Sets the license key for the YouTrack service.

jetbrains.youtrack.logDir

path

~/.youtrack/logs

Sets a custom location for storing YouTrack log files.

jetty.home

path

~/.youtrack/

Sets a custom location for storing YouTrack-specific temp files and application data.

java.io.tmpdir

path

Default temp location that is used by the operating system

Sets a custom location for storing general temp files for the Java platform.

jetbrains.youtrack.locale

IETF language code

en_us

Sets the localization to use in the YouTrack user interface. The following localizations are available by default: en_us, de_de, es_es, fr_fr, and ru_ru. If you use a custom localization for your YouTrack instance, you can specify the language code that matches your custom localization.

Last modified: 7 March 2019