YouTrack InCloud 2017.4 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.

adminSettingsTabLicense thumbnail

If your YouTrack license has expired, you can Switch to Free Pack, or click the Upgrade your plan button to access the YouTrack website and purchase another license.

System

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

systemSettingsInCloud thumbnail
SettingDescription
Max Upload File SizeThe maximum file size allowed for uploaded attachments, in bytes. By default, the maximum allowed file size is 10Mb (10485760 bytes).
Max ordered issuesYouTrack allows users to re-order issues on the Issues list manually. Users can drag issues in the list and place them in order they see fit. This custom order is saved in a so-called "watch folder", which can be a search query, saved search, tag, project or search context. The Max ordered issues parameter limits the number of issues in the list for which a custom order is set when a user accesses the "watch folder". If you have manually ordered the issues in a saved search, you see up to this number of ordered issues at the top of the list. All other issues that match the saved search are then displayed from newest to oldest.
Max Issues to ExportThe maximum number of issues to be exported as HTML or CSV, or to be exported for printing. By default, the limit is set to 500 issues. To change it, just enter a new value.

The Max Issues to Export limit is set to avoid overloading the YouTrack instance.

Visual

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

SettingDescription
Application LogoSets 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.
Default 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 default time zone in their user profiles.
Date Fields FormatSets the system-wide default date format. 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, German, French, Japanese, Russian, and Spanish.

Enable the RTL support option to align the text input fields and all drop-down lists right-to-left. Use this option when your users create issues in a language that is written from right to left.

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.

REST API Settings

In YouTrack, the REST API is always enabled.

In addition to the general REST API, we provide support 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 REST API section of the page:

SettingDescription
Allow all originsEnable to allow access from all origins with the REST API.
Allowed originsEnter a list of origins for which cross-origin requests are allowed.

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.

If you use the mail server that is hosted on our servers, we strongly recommend that you leave these settings unchanged. However, you may want to change the email address that is used as the 'From' address in email messages sent by YouTrack. For more information, see Email 'From' Addresses.

You also have the option to overwrite these settings completely and connect YouTrack to your own mail server. For detailed instructions, see Connect to an External Mail Server.

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

SettingDescription
EmailThis control enables or disables email notifications in YouTrack.
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.
SMTP LoginThe 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.
Select SSL KeyThis drop-down list lets you select a previously uploaded SSL key or trusted certificate for secure connection to your mail server.


To enable a secure connection to an external SMTP server, you need to import its SSL certificate into YouTrack. For instructions, see SSL Certificates.

Server 'From' EmailThe email address that is used as the 'From' address for email notifications. You can either use the format sender name <email@yourdoman.com> or enter an email address without the sender name. For more information, see Email 'From' Addresses.
Send test messageThis 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.

If you use the Jabber service that is provided by YouTrack, we strongly recommend that you leave these settings unchanged.

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.

Here, you also find the option that lets users interact with YouTrack through direct messages in a Jabber client — the Jabber Bot. For more information, see Search for Issues over Jabber and Apply Commands over Jabber.

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

SettingDescription
JabberThis control enables or disables Jabber notifications in YouTrack.
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.
Select SSL KeyThis drop-down list lets you select a previously uploaded SSL key or trusted certificate for secure connection to your Jabber service.


To enable a secure connection to your Jabber service, you need to import its SSL certificate into YouTrack. For instructions, see SSL Certificates.

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.
Enable Jabber BotThis option allows users to interact with YouTrack through direct messages in a Jabber client.
Last modified: 12 December 2017