Installation

How to install UniPortal

Follow the guide below to get your workspace connected and running smoothly right away.

Get the app from the Atlassian Marketplace

1. Log into your target Jira Cloud site with administrator permissions.
2. Locate the UniPortal listing on the Atlassian Marketplace.
3. Choose “Try it free”, pick your designated Jira Cloud environment from the list, and hit “Start free trial” to launch the cloud deployment. (If prompted by a native Jira pop-up, simply confirm the setup).
4. Wait a few seconds for the confirmation alert to appear.

Launch your setup

1. Return to your main Jira Cloud dashboard by selecting the Jira icon in the top-left corner.
2. Open the Apps menu located in the main header navigation.
3. Select UniPortal from your active application list to open the configuration dashboard. That’s it – you’re ready to go!

Step-by-Step Installation Example

To make the multi-instance setup easier to understand, let’s look at a practical example of how you should deploy UniPortal across your environment.

Imagine you have two separate Jira Service Management instances:

• Master Instance: https://instance_one.atlassian.net (Your main site where you want to build the unified portal).
• Slave Instance: https://instance_two.atlassian.net (Your secondary site where you want to pull finance-related tickets).

To set this up correctly, follow these exact steps:

1. Install the app on the Master: Log into instance_one.atlassian.net as an admin, go to the Atlassian Marketplace, find UniPortal, and click Try it free.

2. Install the app on the Slave: Do the exact same thing on instance_two.atlassian.net — find UniPortal on the Marketplace and deploy it there as well.

3. Enable REST API: On both instances, navigate to Manage apps > UniPortal, locate the app details, and ensure the Enable API / REST API toggle is turned ON.

4. Authorize each instance locally (Self-Authorization):

   • On the Master site: Go to instance_one.atlassian.net > Connections, click Connect new tool > Jira Service Management, and choose to connect https://instance_one.atlassian.net (authorizing the master to itself).
   • On the Slave site: Switch to instance_two.atlassian.net > Connections, click Connect new tool > Jira Service Management, and choose to connect https://instance_two.atlassian.net (authorizing the slave to itself).

   Note: Thanks to the shared UniPortal 3LO app backend, the second instance (instance_two) will instantly detect the active setup and establish itself as the Slave connected to your Master.