# Configuration Parameters

This page lists common parameters that are specific to YouTrack. Some system properties are defined when you install or upgrade YouTrack. Others are defined as options in the JVM and can only be updated as command-line parameters during startup or by updating values stored in the JVM options file for your YouTrack installation. To learn how to update these parameters, see [Configure JVM Options](configure-jvm-options.html).

A few parameters listed on this page are available through the user interface, usually from the Global Settings. The best way to update these system properties is to set the desired values in the user interface. Use the links listed for the Location to learn where you can update these settings in the YouTrack UI.

## General Parameters

You can set the following parameters for any YouTrack installation.

| Parameter | Description |
| --- | --- |
|  jetbrains.youtrack.admin.restore  | Restores the password for the default admin user account to the default value `admin`.       * Data type: Boolean    * Default value: false    * Location: [JVM options file](configure-jvm-options.html)   |
|  jetbrains.youtrack.support.email  | Specifies the email address that is used as the `mailto` address for the Contact support link on the error screen.       * Data type: email address    * Default value: youtrack-feedback@jetbrains.com    * Location: [JVM options file](configure-jvm-options.html)   |
|  jetbrains.youtrack.disableCheckForUpdate  | Enables and disables checking for software updates on startup. When set to `true`, checking for software updates is disabled.       * Data type: Boolean    * Default value: false    * Location: [JVM options file](configure-jvm-options.html)    |
|  jetbrains.dnq.textIndex.minPrefixQueryLength  | 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.       * Data type: integer    * Default value: 3    * Location: [JVM options file](configure-jvm-options.html)    |
|  jetbrains.youtrack.mailLimit  | 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 Cloud instances is 100.       * Data type: integer    * Default value: 0    * Location: [JVM options file](configure-jvm-options.html)    |
| jetbrains.youtrack.event.merge.timeout | Sets the amount of time YouTrack waits to compile changes that are applied to an issue as a digest before sending an email notification, in milliseconds.     Reducing this value increases the rate at which YouTrack analyzes notifications and can have a negative impact on general server performance. Increasing this value from the default (one minute) can reduce the overall number of notification emails that are sent by YouTrack.       * Data type: long    * Default value: 60000    * Location: [JVM options file](configure-jvm-options.html)    |
|  jetbrains.youtrack.default.page  | Sets the default start page for your YouTrack server. Enter a relative path to your base URL with a leading slash.       * Data type: string    * Default value: /dashboard    * Location: [JVM options file](configure-jvm-options.html)   |
| jetbrains.youtrack.webHooksBaseUrl | Sets an alternative base URL for your YouTrack server when sending requests to create webhooks in external services.       * Data type: string    * Default value: empty    * Location: [JVM options file](configure-jvm-options.html)   |
| jetbrains.http.request.header.buffer.size | Maximum request buffer size. If you see the `URI is too large >102400` or `Request header too large` warnings/errors in YouTrack logs, increase the value for this parameter.       * Data type: long    * Default value: 102400    * Location: [JVM options file](configure-jvm-options.html)    |
| jetbrains.http.response.header.buffer.size | Maximum response buffer size. If you see the `Response header too large` warning/error in the YouTrack logs, increase the value for this parameter.       * Data type: long    * Default value: 102400    * Location: [JVM options file](configure-jvm-options.html)    |
| jetbrains.youtrack.licenseName | Sets the name of your YouTrack license to the name of your YouTrack Server license.       * Data type: string    * Default value: empty    * Location: [Global Settings \| License Details](license-details.html)    |
| jetbrains.youtrack.licenseKey | Sets the license key of the YouTrack license to your license key for YouTrack Server.       * Data type: string    * Default value: empty    * Location: [Global Settings \| License Details](license-details.html)    |
| jetbrains.youtrack.dumbMode | Lets you run the YouTrack service without connecting to other services inside your network. When `true`, YouTrack doesn't generate notifications, update webhooks, retrieve email messages for Mailbox integrations, or send HTTP requests for workflows.     This can be particularly helpful for staging environments where you want to test new functionality without disrupting users who are working with the live application.       * Location: [JVM options file](configure-jvm-options.html)   |
| jetbrains.youtrack.ai.platform.config.url | Specifies the URL of the AI platform that enables AI-driven features in YouTrack. Use this parameter to integrate with a JetBrains AI platform that is specific to your region. For example, if you're working with YouTrack in China, you can connect to the AI platform located at the following address:      ``` https://www.jetbrains.com.cn/config/JetBrainsAIPlatform.json ```       * Location: [JVM options file](configure-jvm-options.html)    |

## Environmental Parameters

The following parameters are used to manage how YouTrack runs in your server environment.

| Property | Description |
| --- | --- |
| base-url | The URL that end users request to access your YouTrack installation. For example, `https://youtrack.mydomain.com`.       * When the value for the `secure-mode` property is `tls` or your YouTrack installation is secured behind an SSL-terminating reverse proxy server, the URL should begin with `https`.    * Otherwise (when running YouTrack using plain HTTP), the URL begins with `http`.     The default value is either of the following (where `hostname` is the name of the server where YouTrack is installed):       * "http://" + hostname + ":" + listen-port + "/"    * "http://" + hostname + "/" (in case when listen-port is equal to 80)     This value is stored as a `string` data type.       * Location: [Global Settings \| Server Configuration](server-configuration-settings.html)    |
| secure-mode | The connection mode that is applied to the YouTrack server.       * Location: [JVM options file](configure-jvm-options.html)     This property supports the following values:       * `disable` — TLS is disabled. This is the default value for this property.    * `tls` — TLS is enabled.                     |
| listen-address | Sets the net interface address for your YouTrack installation. It might be changed if YouTrack should be configured to listen on some particular net interface.       * Data type: string    * Default value: 0.0.0.0    * Location: [JVM options file](configure-jvm-options.html)    |
| listen-port | Designates the port on which YouTrack listens for HTTP traffic. This port might be changed from one configuration phase to another. By default, port 80 is tried to be used on Windows and 8080 on other platforms.     If port 80 is occupied by another process or is not allowed on your server, YouTrack will automatically start listening on port 8080 and any subsequent available port.     This value is stored as an `int` data type.       * Location: [JVM options file](configure-jvm-options.html)    |
| tls-redirect-from-http | When `true` lets you use an additional port (defined by the `tls-redirect-from-http-listen-port` property) to accept unencrypted HTTP traffic and redirect it to a secure port defined by the property `listen-port`.     The default value is `false`.       * Location: [JVM options file](configure-jvm-options.html)    |
| tls-redirect-from-http-listen-port | Specifies an additional port to accept unencrypted HTTP traffic and redirect it to a secure port defined by the `listen-port` property. To enable this port, set the value for the `tls-redirect-from-http` property to `true`).       * Location: [JVM options file](configure-jvm-options.html)    |
| tls-server-cert-folder | An (optional) absolute path to resolve relative paths defined by other command line parameters, when present. Relative paths to server certificate files that are specified in other properties are resolved against this directory.       * Location: [JVM options file](configure-jvm-options.html)                          The properties that can reference relative paths are:       * `tls-server-cert-key-file`    * `tls-server-cert-file`    * `tls-server-cert-chain-file`    * `tls-server-cert-keystore-file`    |
| tls-server-cert-keystore-file | The location of a keystore file in either [JKS](https://en.wikipedia.org/wiki/Keystore) or [PKCS #12](https://en.wikipedia.org/wiki/PKCS_12) format.       * Location: [JVM options file](configure-jvm-options.html)    |
| tls-server-cert-keystore-password | Keystore integrity password       * Location: [JVM options file](configure-jvm-options.html)    |
| tls-server-cert-keystore-key-alias | The alias of the entry in the keystore that contains the server certificate and the private key.       * Location: [JVM options file](configure-jvm-options.html)                          If your keystore uses the [PKCS #12](https://en.wikipedia.org/wiki/PKCS_12) format, follow these guidelines:       * Use the value that is stored as the `friendlyName` in the keystore.    * If the private key and certificate pair was not marked with a `friendlyName` during generation, use this parameter to provide the sequential number of this pair in the keystore. For a keystore that only contains one certificate and private key pair, set the value to `1`.    |
| tls-server-cert-keystore-key-password | Password that protects your server's private key entry in the keystore.       * Location: [JVM options file](configure-jvm-options.html)    |
| tls-server-cert-key-file | The location of a private key ([PKCS #1](https://en.wikipedia.org/wiki/PKCS_1) or [PKCS #8](https://en.wikipedia.org/wiki/PKCS_8)) file, stored in [PEM](https://en.wikipedia.org/wiki/Privacy-Enhanced_Mail) format.       * Location: [JVM options file](configure-jvm-options.html)    |
| tls-server-cert-file | The location of a certificate file, stored in [PEM](https://en.wikipedia.org/wiki/Privacy-Enhanced_Mail) format.       * Location: [JVM options file](configure-jvm-options.html)    |
| tls-server-cert-chain-file | The (optional) location of a file that contains the certificate chain, stored in [PEM](https://en.wikipedia.org/wiki/Privacy-Enhanced_Mail) format.       * Location: [JVM options file](configure-jvm-options.html)    |
| tls-server-cert-private-key-passphrase | If you use an encrypted private key, then use this property to provide the passphrase that was used for encryption. Supported for both [PKCS #1](https://en.wikipedia.org/wiki/PKCS_1) and [PKCS #8](https://en.wikipedia.org/wiki/PKCS_8) formats.       * Location: [JVM options file](configure-jvm-options.html)    |
| data-dir | Sets the directory where YouTrack stores application data.       * Location: [JVM options file](configure-jvm-options.html)    |
| temp-dir | Sets the directory where YouTrack stores temporary files.       * Location: [JVM options file](configure-jvm-options.html)    |
| logs-dir | Sets the directory where YouTrack stores application logs.       * Location: [JVM options file](configure-jvm-options.html)    |
| backups-dir | Sets the directory where YouTrack stores time-specific copies of the database in backup folders.       * Data type: string    * Default value: `<youtrack_home>\backups`    * Location: [JVM options file](configure-jvm-options.html)    |
| hub-url | Stores the web address of an external Hub service, when used.       * Location: [JVM options file](configure-jvm-options.html)    |
| statistics-upload | Determines whether YouTrack is allowed to collect and share anonymous usage statistics with JetBrains.     This property is normally set by the administrator in the web-based Configuration Wizard during installation.       * Data type: Boolean    * Default value: false    * Location: [JVM options file](configure-jvm-options.html)    |
| no-browser | Launches the application without opening a browser window on startup. Use this parameter to run the YouTrack service on a machine without launching unneeded applications or where browser software is not installed.       * Location: [JVM options file](configure-jvm-options.html)    |

## Authentication Throttling Parameters

The following parameters let you enable or disable throttling in YouTrack.

| Parameter | Description |
| --- | --- |
| jetbrains.hub.auth.login.throttling.enabled | Sets the status of the throttling feature for the Hub authentication module. When true, authentication throttling is enabled.       * Data type: Boolean    * Default value: false    * Location: [JVM options file](configure-jvm-options.html)    |