YouTrack InCloud 2021.1 Help

Global Settings

This page describes the global settings for YouTrack. These settings are available in the Server Settings section of the Administration menu.

License

The first section of the Global Settings page provides detailed information about your current license and its limitations.

YouTrack InCloud licence details

The graph in this section of the page lets you track whether the number of active users and total disk space exceed the limitations for your license. Potential charges for overuse are shown above the graph, next to the current number of active users and used disk space.

If your YouTrack license has expired, click the Upgrade your subscription button to access the YouTrack website and purchase another license. You can also switch to the free plan, purchase licenses for additional users, or switch between monthly or annual billing. For more information, see Managing Your License.

System

The System section provides options that let you configure the basic system settings of your YouTrack server.

system settings for YouTrack InCloud
SettingDescription
Max upload file size

The maximum file size allowed for uploaded attachments, in bytes. By default, the maximum allowed file size is 10 MB (10485760 bytes).

For YouTrack InCloud instances, this limit cannot exceed 100 MB.

Max issues to export

The maximum number of issues that can be printed or exported in CSV, Excel, or HTML format. By default, the limit is set to 500 issues. To change it, just enter a new value.

Administrator email

The email address of the primary contact for the YouTrack support team. The support team uses this information to determine whether a user is authorized to request major changes to the YouTrack instance. This includes requests to restore the database or migrate data between instances.

The default value is set to the email address of the user who registered the YouTrack InCloud instance. Update the value for this setting when the person who is responsible for the administration of your YouTrack instance is different from the user who registered the instance or purchased the license plan.

Data center locationThe location of the data center that hosts your YouTrack InCloud instance. This value is set when the instance is registered. If you want to move your instance to a different data center, submit a request to YouTrack InCloud Support.
System-wide bannerWhen enabled, displays a system-wide banner at the top of every page for every user in YouTrack. To learn more about this feature, see Display a System-wide Banner.
Read-only mode

Puts the database in a state that allows read access, while blocking update operations.

In read-only mode, YouTrack continues to provide access to information for users who are working with the application, but does not accept changes. If you're experiencing problems with YouTrack, you can activate read-only mode while you investigate and isolate the issue. You can also use this setting to temporarily stop changes and reduce the size of your pending async job or notification analyzer queues.

Visual

The Visual section provides options that let you manage system settings related to the visual presentation in YouTrack.

SettingDescription
Application logo

Sets a custom logo for YouTrack. The custom logo is displayed in the header for all pages in the system. To use a custom logo, click the Edit icon, then choose an image file from your local directory. You can upload a JPG, GIF, or PNG file. Your image is automatically resized to 250 x 80 pixels.

To replace a custom logo with the YouTrack application logo, click the Set to default button.

Time zoneThis set of controls determines the system-wide default time zone. The time zone set here is used for time presentation for all users. Users can change the local time zone in their user profiles.
Date formatSets the system-wide default presentation for dates and times. This format is applied to all custom fields that use the date field type.

System Language

You can set the system language of your YouTrack server to one of the localizations that are provided out-of-the-box. YouTrack provides localization support for English, French, German, Japanese, Russian, and Spanish.

Additional languages that are supported by the YouTrack user community are also available. These languages are marked with a community label in the list. For more information, see Community-based Language Support.

Users can select their personal language preference in their user profile. For consistency across the application, the language that is set at the global level is used for search queries, commands, and custom fields. The page headers, menus, and controls are displayed in the preferred locale. For more information, see YouTrack General Profile Settings.

To align the text input fields and all drop-down lists right-to-left, enable the RTL support option. For more information, see Right-to-Left Language Support.

Keyboard Shortcuts

This section provides options that let you set up the keyboard shortcuts scheme. You can use the default shortcut scheme or add and use your own customized scheme. For more information, see Customize Keyboard Shortcuts.

Resource Sharing

In addition to the general REST API, which is always enabled, YouTrack supports for cross-origin resource sharing, or CORS. CORS support lets you enable JavaScript access to your YouTrack instance. For more information, read about cross-origin resource sharing on Wikipedia. You can also download samples of CORS usage here: https://github.com/vadimgurov/youtrack-cors-samples.

To enable access from a site (origin), select and configure either of the following parameters in the Resource Sharing section of the page:

SettingDescription
Allow all originsEnable to allow access from all origins with the REST API.
Allowed originsEnter a line-separated list of origins for which cross-origin requests are allowed. Specify each origin by domain name, including protocol and port number where applicable.

Notifications

This section provides options that let you configure how users are notified of changes to issues in YouTrack.

Email-related Settings

In YouTrack InCloud, email notifications are enabled and configured by default. This section of the settings page lets you view the configuration used to send email notifications to users.

To disable sending email notifications from your YouTrack server, deselect the Enable checkbox.

SettingDescription
EmailThis control enables or disables email notifications in YouTrack.
Configuration

Determines whether your YouTrack InCloud instance is connected to an email service that is hosted by JetBrains or an external email server. The following options are available:

  • Default — your YouTrack instance is connected to the email service that is hosted by JetBrains. Additional settings for connecting to an external mail server are hidden.

  • Custom — your YouTrack instance connects to an external mail server. To learn how to connect to your own mail server, see Connect to an External Mail Service.

SMTP hostThe server address of your mail server.
SMTP portThe connection port for the mail server.
Mail protocolThe protocol that is used by your mail server.
Connect anonymously

When enabled, YouTrack connects to your SMTP server without sending a username and password. Use when your SMTP server does not require authentication.

When this option is enabled, the input fields for SMTP username and SMTP password are disabled. Values that are stored in these settings are ignored.

SMTP usernameThe username of the account that is used to access the mail server.
SMTP passwordThe password for the account that is used to access the mail server.
SSL key

This list lets you select an SSL key that contains a trusted certificate and its public and private key pairs. The key identifies YouTrack as a client when it tries to connect to your mail server.

From address

The default address for sending email notifications from YouTrack. This sets the value for the "From:" field in the email header. You can either use the format sender name <email@yourdomain.com> or enter an email address without the sender name.

This setting is only available when your YouTrack InCloud instance is connected to a custom mail server.

For more information, see From and Reply-to Addresses.

Sender name

The name that is shown in email client apps as the sender for email notifications that are generated for your YouTrack instance. Use this setting to override the sender name that is used at the global level.

This setting is only available when your YouTrack InCloud instance uses the default connection for email notifications.

Reply-to addressAn optional address to which email replies are sent. This sets the value for the "Reply-To:" field in the email header for messages that are sent by YouTrack. Use this setting when, for example, the address that you use to send email notifications cannot receive replies.
Send test emailThis control lets you test the connection to your mail server by sending a test message to a specific email address.

Jabber-related Settings

In YouTrack InCloud, notifications over Jabber are enabled and configured by default. This section of the settings page lets you view the configuration used to send messages over Jabber and the system account from which notifications are sent to users.

You also have the option to overwrite these settings completely and connect YouTrack to your own Jabber service. For detailed instructions, see Enable Notifications over Jabber.

To disable sending notifications over Jabber, deselect the Enable check box.

SettingDescription
JabberThis control enables or disables Jabber notifications in YouTrack.
Configuration

Determines whether your YouTrack InCloud instance is connected to a Jabber service that is hosted by JetBrains or an external Jabber service. The following options are available:

  • Default — your YouTrack instance is connected to the Jabber service that is hosted by JetBrains. Additional settings for connecting to an external Jabber service are hidden.

  • Custom — your YouTrack instance connects to an external Jabber service. To learn how to connect to your own Jabber server, see Enable Notifications over Jabber.

Jabber serverThe server address of your Jabber service.
Jabber server portThe connection port for the Jabber service.
Jabber service nameThe name of your Jabber service. Use when the service name and address (hostname) are not the same. This setting is commonly required for ejabbered servers.
Jabber usernameThe username of the account that is used to access the Jabber service. Use the format username@domain.
Jabber passwordThe password for the account that is used to access the Jabber service.
SSL keystore

This list lets you select an SSL keystore that contains a trusted certificate and its public and private key pairs. The keystore identifies YouTrack as a client when it tries to connect to the Jabber service.

Use legacy SSLThis option disables the certificate validity check for the SSL connection. Recommended only when you are using jabber.org to send notifications and encounter a problem with the connection to the Jabber service.
Send test jabber messageThis control lets you test the connection to your Jabber service by sending a test message to a specific Jabber account.

Experimental Features

This link provides access to the Feature Configuration page. Here, you find a list of experimental features that you can enable system-wide and other features that you can enable for specific groups.

For more information, see Experimental Features.

Slack Integration

This link opens a page that lets you add the YouTrack App to a workspace in Slack. For more information, see Slack Integration.

Last modified: 16 March 2021