YouTrack Standalone 2017.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 latest version, read the upgrade installation instructions before you start.

Set Up a New YouTrack Server

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.



Install YouTrack

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

Global SettingsCheck 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 and Jabber.

Database Backup

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

Migrate to YouTrack

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

RolesYouTrack 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 Developer 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 lead. For more information, see Manage the Project Team.

GroupsCheck 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 Developer role.

UsersAdd 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.

ProjectsWhen 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 lead.

By default, the Project Admin role only lets users manage existing projects. This means that users with the System admin role have to create the project, then hand it over to a project administrator. If you want to let users create and manage their own projects, you need to grant them the Create Project permission as well. You can either create a new role that includes this permission and grant it to specific users, or enable the Create Project permission for the Project Admin role.

Customize and Extend YouTrack

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



Time TrackingThe default time tracking settings use five 8-hour workdays from Monday to Friday. If your organization uses a different schedule, you can modify the default settings for your YouTrack server.

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 TemplatesIf you want the messages that are sent by YouTrack to follow your brand identity, you can customize the messages that YouTrack sends over email and Jabber.

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

WorkflowsCustomize 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.

IntegrationsSet 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 IntegrationsSeveral 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: 7 March 2019