How can I connect JIRA Server or JIRA Data Center?

Overview

Please contact your Customer Success Manager as it is required when setting up your JIRA Server and/or JIRA Data Center instance.

Before you get started:

• The credential requirements are based on the JIRA server version

  • Jira Server 8.14 or Data Center and above require Jira account email address and personal access token.

  • Jira Server 8.13.x and below require Jira username and password.

• We strongly encourage using Jira credentials with Admin permissions. If the credentials you provide do not include Admin permissions, you must also manually configure Jira webhooks for Velocity.

Setup Process

Go to the Velocity Project Management Tool Settings page here

1. Fill in the form

   1. JIRA Version: Jira Server V2 or (if you use Data Center, you should select Jira Server V2 in this section) Data Center

   2. Hostname (i.e. your domain name)

   3. Personal Access Token

      1. Jira Server 8.14 or Data Center and above: Personal access token

      2. Jira Server 8.13.X or below: Jira password

   4. Email address associated with Personal Access Token

      1. Jira Server 8.14 or Data Center and above: Email address

   5. Jira Server 8.13.X or below: Jira username

   6. Click “Create project management tool”

If you have an on-premise agent you should contact your Customer Support Manager for additional assistance.

Next Steps

Once you hook up your Jira instance, learn how to add projects into Velocity here.

Related Resources

If you use JIRA Cloud, go to this link for setup instructions.