Administration

Instant Installation

YouTrack is distributed as a JAR, Windows EXE or WAR file, ready to:

• run as a standalone Java process
• be launched as Windows service
• be deployed at any of today's popular application servers, including Apache Tomcat 6+, Apache Geronimo, Mortbay Jetty, Caucho Resin, and JBoss.

YouTrack is supplied with the built-in JetBrains Database. This is a database system created by JetBrains that has undergone a lot of development and testing. JetBrains database runs in-process and requires no installation, meaning database integration will never cause you any pain.

Administrator's Area

Administering YouTrack will not require more effort than it's worth. In the Administrator's Area, you can:

• Configure access using four entities: permissions, roles, groups and users.
• Create new projects or import existing projects from JIRA.
• Create and manage custom attributes for your projects.
• Schedule and launch database backups.
• Configure text indexing.
• Connect YouTrack to your directory service.
• Enable single-click OpenID authentication.
• Integrate with JetBrains TeamCity or Atlassian JIRA.
• Setup mailbox integration.

Custom Attributes

The whole set of issue attributes is converted into customizable. The following types of custom attributes are available: Enumeration, Date, String, Integer, User, Group, Version, State, Build and Subsystem. As a result, you are free to populate any issue attributes with the exact values you need.

For example, you'll be able to define your own states, types or priorities, set default values, highlight attribute values with different colors, or even allow multiple selection of assignees.

All the functionality previously provided for predefined attributes is available for custom attributes as well, including import from JIRA, export to Excel, support in search queries and commands, and administration via REST API.

The process of creating custom attribute is aided by special wizard which leads you through the entire process of creating and defining values and attaching a custom attribute to project(s).

Using custom attributes you can also:

• Configure defaults for a new issue. For example, you can set the default priority, type, subsystem, etc.
• Add the aliases to your custom attributes to be used in search queries and commands. For example, you may set for or assigned to alias for Assignee attribute.
• Set a custom attribute as required on project level. For example, require that Effected Version be specified to submit a new issue. Also, you can clone the enumeration set of values to be used for another attribute.
• Change order of issue attributes: allows you to configure the order of issue attributes either on specific project level or for all projects.
• Customize attribute privacy: show certain attributes to everyone or to members of a specific group only.

Customizable Workflow

YouTrack Workflow is a set of rules that can be attached to a project to define the life-cycle of the project's issues.

For example, you can setup the rule to assign an issue to QA team or specific QA person automatically when issue state is changed to Fixed, or require to define build number when closing an issue, or setup to receive notifications about issues that haven't been proceed during specific time period. Generally, customizable workflow combined with the customizable attributes gives you the ability to completely customize your issue tracking process.

In order to create our own workflow or edit the existing one, download YouTrack Workflow Editor. Read more about YouTrack Workflow.

JIRA Integration

If you have an existing JIRA installation (up to version 4.x), consider importing your JIRA projects to YouTrack.

Just get a YouTrack plug-in for JIRA, choose a project and types of bugs to import, and make your issues available from YouTrack. You can import issues along with groups, roles, and group memberships, meaning that your users will be able to log into YouTrack with their existing JIRA credentials.

If you choose to work with JIRA and YouTrack concurrently, you can update issue changes from JIRA to YouTrack at any time.

LDAP Integration

LDAP integration lets you connect YouTrack to your directory service so that users in your organization are able to log into YouTrack with the same credentials that they use with other corporate applications.

This feature is available in all the YouTrack 3.x User Packs.

OpenID Integration

YouTrack lets you enable authentication through any or all of four supported OpenID providers: Google, Yahoo, America Online, and Blogger.com.

Your users will benefit from a single-click sign-on functionality which is especially useful for casual bug reporters.

TeamCity Integration

+

By integrating with JetBrains TeamCity, you synchronize changes submitted through TeamCity with issue attributes in YouTrack.

For example, if a comment submitted with a TeamCity change contains an issue ID, the issue can be automatically marked as fixed and the Fixed in build attribute is filled with a corresponding build number. You can specify any command to be applied to issues included in the current build, i.e issues mentioned in the commit comments and issues resolved in this build.

YouTrack suggests multiple ways to integrate with TeamCity - for example, mapping multiple TeamCity build configurations to a single YouTrack project, or integrating multiple TeamCity installations with a single YouTrack installation. Read more about TeamCity Integration.

Applying Commands from VCS Commit Comment

YouTrack integrates with VCS via TeamCity. You can just type a command right in the VCS commit comment, and it will be applied to the issue associated with this commit. For example, if you commit files with a comment like #JT-1787 fixed tag to be documented, issue JT-1787 will be closed and tagged as "to be documented."

YouTrack REST API

YouTrack provides powerful functionality that helps you perform various actions programmatically via its RESTful API, including:

• Importing issues from your current bug tracking system - for smoother migration to YouTrack.
• Creating, modifying, and performing other operations programmatically — so you can seamlessly integrate YouTrack into your environment. For example, via automated issue submission from third-party applications.
• Manipulating projects, users, groups, roles, issue link types, and custom attributes.