Before installing the TeamCity Integration for Jira add-on, check compatibility between add-on, TeamCity and Jira versions.


First, you will need to configure your TeamCity instance:

  1. Make sure that Rest API Plugin is enabled. To do that go to the following URL: <your-teamcity-server>/httpAuth/app/rest/application.wadl. You should see the output as shown below
  2. Configure integration with Jira as described here

    If you want to provide TeamCity with access to all Jira projects, click the Get All Projects link in the window Create New Issue Tracker Connection. Otherwise, specify the projects you want to grant access to in the Project Keys field as shown below. The Jira user specified in the Username field should have access to relevant Jira projects.

  3. Assign the Project Viewer and Agent Manager roles to an existing TeamCity user or first create a new user and assign the roles.

For the Agent Manager role you can set only the 'View agent details' permission in TeamCity.