Azure DevOps for Jira
Azure DevOps for Jira
Breadcrumbs

How to configure Azure DevOps On-Premises

This guide explains how to connect Azure DevOps Server (On-Premises) to Azure DevOps for Jira.

Before following this guide, make sure that Azure DevOps for Jira has already been installed on your Jira Cloud site. For installation instructions, see Installing Azure DevOps for Jira.

Before you begin

Before configuring the integration, make sure you have:

  • Jira administrator permissions.

  • Access to the Azure DevOps Server instance you want to connect.

  • Permission to create a Personal Access Token (PAT) in Azure DevOps.

  • An Azure DevOps Server instance that is accessible from the internet.

Step 1. Create a Personal Access Token

Azure DevOps for Jira uses a Personal Access Token (PAT) to connect to your Azure DevOps Server instance.

Create a PAT in Azure DevOps with the following permissions:

  • Code: Read

  • Build: Read

  • Release: Read

If you want to use the same PAT to create branches through Jira, also include:

  • Code: Write

For more information about creating a PAT, see the Microsoft Azure DevOps documentation.

Global Personal Access Tokens scoped to all accessible organisations will no longer be supported by Microsoft from December 1, 2026. We recommend creating a PAT for the specific Azure DevOps organisation you want to connect instead.

Make a note of the PAT and its expiration date. You will need the PAT when creating the integration.

Step 2. Create an Azure DevOps integration

Once you have created your Personal Access Token (PAT), you can connect Azure DevOps to Jira.

  1. Go to the Marketplace apps section of your Jira administration by clicking the Settings cogwheel in the top-right corner and selecting Marketplace apps.

    image-20260822-005838.png


  2. Expand Azure DevOps and select Dev Activities in Jira.

    image-20260822-010110.png


  3. Select Integrate with Azure DevOps.

    image-20260822-005927.png

  4. Select Azure DevOps Server (On-Premises).

    image-20260825-023103.png

  5. Enter your Personal Access Token.

    image-20250322-003748.png

  6. Enter the Azure DevOps domain URL.

    image-20250322-004725.png

The Azure DevOps Server instance must be accessible from the internet so that Azure DevOps for Jira can connect to it.

  1. Enter the Azure DevOps organisation associated with your PAT.

    image-20250322-005109.png

  2. Optionally, enter the PAT's expiration date to receive a reminder on the configuration page when the token is approaching its expiration date.

    image-20260825-023740.png

  3. Show Deployments in Jira Development Panel is selected by default. If you do not want deployments to appear in the Jira Development panel, clear this option.

    image-20260822-012243.png

  4. Enter a suitable Integration name, then select Save.

    image-20260825-024602.png

The Azure DevOps integration is now configured.

Step 3. Connect Azure DevOps projects

After saving the integration, the Project connections tab opens.

image-20260825-025506.png

To connect an Azure DevOps project:

  1. Select Create project connection.

    1. Select the Azure DevOps project you want to connect, then select Save.

    image-20260825-025709.png

  3. To connect another project, select Create project connection and repeat the process.

    image-20260825-025812.png

Repeat this process for each additional Azure DevOps project you want to connect.

Once a project is connected, development activity from that Azure DevOps project can be linked to Jira work items.

Updated: August, 2026