Install to Data Center and Server Jira Instances

Learn how to install Jira Integration+ into your Jira Data Center or Server instance. This is an essential part of using Jira Integration+.

To install into Jira Cloud instances, use this guide: Install to Jira Cloud.

What to know:

• You need Jira administrator permissions for your Jira instance.
• You will need Teams administrator permissions before the app will fully work, or another person with Teams administrator permission will have to approve the app on behalf of your organization after you install it.

Install the app to Jira Data Center or Server

1. Go to your Jira URL (for example "company.atlassian.net").
2. Click on Settings in the navigation.

   

3. In the dropdown select Manage apps.

   

   You may have to re-authenticate that you have administrator permissions. If prompted with a login screen, log in to your admin account.
4. Click on Find new apps.

   

5. Search for Microsoft Teams Integration+ for Jira.
   If you can't find the app because it isn't compatible with your type of Jira, skip to step 9. You can still install the app by side-loading it (installing it directly).
6. Once you find the app listing, select Free trial OR Buy now.

   

7. Select Accept & install.

   

8. If installation is successful, you will see a success modal. Select Close.

   

   If there is an error or issue, repeat the steps above to install the application again. If you continue to have issues, contact your Jira / IT administrator(s). Contact us for additional support.
9. If you are side-loading the app, use these steps. Otherwise, you can skip directly to step 10.
   1. After clicking on Manage apps, select Upload app.

      

   2. Contact us at product@nextup.ai for the latest Data Center / Server app version for side-loading.
      You can directly install the Data Center app (without side-loading it). We recommend doing so if possible as it is easier for you.
   3. Once you have the file, select Browse.

      

   4. Select the .jar file of the app and select Upload

      

   5. If installation is successful, you will see a success modal. Also, the page may automatically reload showing that the app is installed.
      1. Click Close if you see a success modal.

         

      2. Reload the page if you don't see the app listed.
         If there is an error or issue, repeat the steps above to install the application again. If you continue to have issues, contact your Jira / IT administrator(s). Contact us for additional support.
10. Select the application.

    

11. Select Configure.

    

12. The app should offer the user a connection code. Don’t leave this page yet.

    

13. Go to Microsoft Teams in a new tab or window (or the native app).
    We recommend you use the web app as it has fewer issues.
14. Go to the Jira Integration+ app inside of Teams.
    1. If you haven't installed the app in Teams yet, follow this guide.
15. Once installed, go to the chat with the bot and type “status” command

    

    1. You will prompted to sign in to Microsoft if you haven't already signed in within the Jira Integration+ app. This is for additional security.
    2. If you are authorized, the bot will offer to establish the Jira connection.
16. Copy the connect code from the app in Jira.

    

17. Paste the connect code into the chat with the bot.
    1. Click the link saying "Continue".
18. The app will guide you through the rest of the process.

Once you have finished, there are many ways to check if things are working properly

The status command

1. In chat directly with the bot, type the status command.
2. You should see 3 green check marks and the URL of the Jira you are connected to.

   

   If so, then the bot is fully operational and is ready to use!
   If not, go through the connect process starting from the beginning.

The help command

1. Go to chat with the bot, or go to a channel with the bot installed.
2. Type the help command and send it (if in a public channel, add @Jira Integration Plus before the word help ("@Jira Integration Plus help").
   If you get a response with the bot commands, you are logged in and ready to start using the bot!
   If not, follow the steps above from the beginning and redo the connection process on this guide from the start.

Load the application in Jira

1. Go to your Jira and click on Apps.
2. Click on the Jira Integration+ app.

   

3. You should see a dashboard that looks like this image instead of the connect code screen you saw before:

   

   If so, then the bot is fully operational and is ready to use!
   If not, go through the connect process starting from the beginning.

Use other bot functionality

Load a default tab

1. Go to chat with the bot
2. Click on Assigned to me (or Reported by me or Watched by me)

   

3. If you see a list of issues (or a message that no issues match that scenario), you are logged in!

Try anything in these guides.

• If they work as described, you have set up the bot correctly!
• If not, redo the process in this article.

Not working?

1. Make sure a Jira global admin installed the app to Jira.
2. Make sure a user with Teams administrator permissions installed the app to Teams. If not, after the app is fully installed and set up, make sure a user with Teams administrator permissions consents on behalf of your organization.
   1. After you install the app, all Teams admins will be prompted to grant permission to Jira Integration+. After one does, the app will work.
   2. Contact a Teams admin to grant permission to the app after you install.
3. Make sure pop-ups are allowed.
4. If you are behind a firewall read this article.
5. Contact us for support! We recommend scheduling a time by clicking here: https://calendly.com/nextupai/support. Or you can click contact at the top of this page, chat with us on our website, or email product@nextup.ai.

Whats next?

• Configure Team Notifications to replace Jira emails with Microsoft Teams messages
• Understand Creating a Jira issue from Teams.
• Utilize the bot by using Chat to create, find, and manage Jira issues
• Learning to Add the Bot to a Team