YouTrack Server
 
2019.2
Get YouTrack Standalone
You are viewing the documentation for an earlier version of YouTrack Server. View this page in the current documentation
  1. Administration
  2. Server Settings
  3. Global Settings
  4. Enable Email Notifications

Enable Email Notifications

Last modified: 17 December 2019

On the Global Settings page, you configure the connection between YouTrack and a mail server. This enables notifications in YouTrack over email.

note

Enable email!

If your installation uses a built-in Hub service, the connected mail server also sends invitations to register an account, verification emails, and password recovery instructions. If email notifications are disabled or configured incorrectly, your users do not receive any of these messages.

SMTP settings

To enable email notifications:

tip

Requires permissions: Low-level Admin Write

  1. Select the Enable checkbox for Email.

  2. Enter values for the following settings:

    Setting

    Description

    SMTP host

    Enter the server address of your SMTP server.

    SMTP port

    Enter the connection port for the SMTP server.

    Mail protocol

    Select the protocol that is used by your SMTP server.

    Connect anonymously

    If your SMTP server does not require authentication, enable this option.

    When enabled, YouTrack connects to your SMTP server without sending a login and password. The input fields for SMTP login and SMTP password are disabled. Values that are stored in these settings are ignored.

    SMTP login

    Enter the username of the account that is used to access the SMTP server.

    If you're connecting to Gmail, additional security requirements may apply. For details, see Special Requirements for Connecting to Gmail.

    SMTP password

    Click the Change password button to specify the password for account that is used to access the SMTP server.

    SSL key

    Select a previously uploaded SSL key or trusted certificate for secure connection to your mail server. For details, see SSL Keys.

    note

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

    From address

    Enter the address that you want to use to send email notifications. For more information about email addresses, see From and Reply-to Addresses.

    Reply-to address

    Enter an optional address that you want to use for email replies. For more information about email addresses, see From and Reply-to Addresses.

  3. When finished, click the Save button.

  4. Test the connection.

    • Click the Send test message button.

    • Enter an email address to which the test message should be sent.

      Send test message to email address

    • Click the Send button.

  5. Check the email account that you sent the test message to and verify that the message was delivered.

    • If successful, the connection to your external mail service is configured and ready for use.

    • If unsuccessful, update your settings and test the connection until the message delivery is successful.

Special Requirements for Connecting to Gmail

Google accounts have settings that restrict access to third-party applications that use less secure sign-in technology. By their definition, this applies to connections that authenticate with a username and password, which are vulnerable to hijacking.

The setup requirements are based on the current setting for managing less secure apps. The requirements apply to the Google account that you use to authenticate with the Gmail server.

If you're connecting with a Google account that you manage yourself, the following options are available:

  • Generate an application-specific password (App Password) in your Google account and use it for authentication. Leave the option to enable access for less secure apps in your Google account Off.

    App Passwords can only be used with accounts that have 2-Step Verification turned on.

  • Enable Less secure app access for your Google account and connect using your username and password (not recommended).

If you use a Google account that is managed by your organization as part of G Suite, verify which of the following settings is currently enabled for your domain.

Setting

Requirements

Disable access to less secure apps for all users

The Google account that you use for authentication must have 2-Step Verification enabled. To connect to the Gmail server with this account, generate an application-specific password in your Google account.

  • For the Username, enter the username for your Google account.

  • For the Password, enter an application-specific password that you generated in Google.

Allow users to manage their access to less secure apps

You may be able to connect to the Gmail server with your Google username and password. This setup is only available when:

  • You have enabled the option to allow access to less secure apps in the Google account that you use to connect to the Gmail service.

  • You have not enabled 2-Step Verification for this Google account.

If you have enabled 2-Step Verification for this Google account, you need to generate and use an application-specific password. Configure the email notification settings in YouTrack as if access to less secure apps were disabled.