YouTrack Server 2024.2 Help

System Admin Quick Start Guide

If you are responsible for the administration of a new YouTrack instance, here is a list of topics that you might find helpful. These topics are listed in the order that you would normally perform the tasks that are described on each page.

If you are upgrading an existing installation to the latest version, read the upgrade instructions for your distribution type before you start.

Set Up a New YouTrack Site

When you're just getting started, you need to make sure that YouTrack is set up the way you want it and that the people who need to work with issues and manage projects have the appropriate level of access. Use the topics in this list to guide yourself through this process.



Installation and Upgrade

Your first step is to get your YouTrack installation up and running. There are separate installation instructions for each distribution package.

Global Settings

Check the global settings for your YouTrack server. There are several options that you should configure before you make the service available to other users.

On the Global Settings page, you can:

  • Manage your YouTrack license.

    If you didn't set your license key during installation or upgrade, paste it into the License Key input field.

  • Set the default time zone.

  • Set the visual presentation for fields that store date values.

  • Change the system language.

  • Enable notifications over email.

Database Backup

Verify the location, format, and interval for storing backup copies of your YouTrack database.

YouTrack to YouTrack Migration

If you are migrating to YouTrack, learn how to import issues from another issue tracker.


YouTrack provides a handful of predefined default roles for managing user permissions. Familiarize yourself with these roles and the access rights that are enabled for users when they are assigned a role in a project.

The default roles provide standard levels of access for different types of users. You can add and remove permissions for the default roles or create your own.

The default Contributor role has the team option enabled. Users who are added to a project team that is assigned this role are granted this role in the project. The default Project Admin role is assigned to the project owner. For more information, see Manage the Project Team.


Check your groups and verify which roles are assigned to them. If you want to assign a specific set of permissions to a group of users, create a group and grant one or more roles that grant access to the required set of permissions. Pay attention to any group that has the auto-join option enabled. New users are added to these groups automatically and inherit the roles that are assigned to these groups.

When you import issues from another issue tracker, the projects that these issues are assigned to are created automatically, as are groups for each project team. Members of these groups are assigned the default Contributor role.


Add user accounts to the system. There are several options that you can use to create user accounts in YouTrack.

When you let users register their own accounts or log in with an external authentication provider, use the Auto-join Groups option to grant users a specific set of permissions automatically.


When you import issues from another issue tracker, the projects that these issues are assigned to are created automatically. If you want other users to manage these projects, edit each project and choose which user is assigned as the project owner.

By default, the Project Admin role is granted the Create Project permission. This permission grants users the ability to create projects in the global scope. If you want to let users create and manage their own projects, just add these users to a group that is assigned the Project Admin role or grant the role to the user directly in the Global project.

Upgrade Your YouTrack Installation

In summary, updating YouTrack is crucial for maintaining security, fixing bugs, introducing new features, ensuring compatibility, and staying in compliance with industry standards. Regular updates are part of good system administration practices to keep the software environment reliable, secure, and up-to-date with the latest advancements.

To find instructions for upgrading your YouTrack installation, please refer to the Installation and Upgrade section of the documentation.

Customize and Extend YouTrack

Once you have finished with the basic setup, there are a few more settings and features that you can configure at the global level as an administrator.



Time Tracking

The default time tracking settings use five 8-hour workdays from Monday to Friday.

You can also add work item types to the system. These work item types are available for use in all projects that have time tracking enabled.

Project managers can activate time tracking on a per-project basis.

Notification Templates

If you want the messages that are sent by YouTrack to follow your brand identity, you can customize the messages that YouTrack sends over email.

Project managers can also customize notification templates on a per-project basis.


Customize and automate how issues are processed by YouTrack by scripting workflows. You can write your own workflows, or download custom workflows from our repository in GitHub.

Anyone with low-level administrator permission can update the workflows for your YouTrack system.


Set up a standard integration to connect YouTrack with an external service.

Enable and configure these integrations under the Integrations section of the Administration menu.

External Integrations

Several third-party services let you connect to YouTrack from an external application. If you are the administrator for any of these tools in your organization, you can integrate them with YouTrack to enhance productivity.

Last modified: 12 July 2024