Balsamiq for Jira Docs > Balsamiq for Jira Server Documentation > Balsamiq Wireframes for Jira Server Admin Guide

Balsamiq Wireframes for Jira Server Admin Guide



This page contains installation, registration, updating and uninstalling instructions for Balsamiq Wireframes for Jira Server when installed on your own server.

Note: If you are using Jira Cloud (on atlassian.net), please see this article instead.

Usage instructions for the app are in the Balsamiq Wireframes for Jira Server Introduction.


Installation Instructions

Like most Atlassian apps, Balsamiq Wireframes for Jira is installed via Atlassian’s Universal Plugin Manager, or UPM.

To install the app, go to the Jira Administration page, select "Find new apps" from the apps panel and search for Balsamiq Wireframes for Jira Server.

Click on "Free Trial" and accept the license agreement for Balsamiq Wireframes for Jira Server to begin the installation.

You will then begin a 30-day trial evaluation of Balsamiq Wireframes for Jira Server.


Registration Instructions

Please make sure you read the Balsamiq and Atlassian Marketplace FAQ first.

To register the app, go to the Jira Administration page. Select "Manage new apps" and search for Balsamiq Wireframes for Jira Server.

If you want to buy from Atlassian Marketplace, you can use the "Buy now" button.

If you already bought a license from Atlassian Marketplace, you can paste it in the text area and click the "Update" button to save it.

If instead you purchased your license directly from Balsamiq click on the "Configure" button and follow the instructions on the configuration page to paste your License Information and see the status of your current installation.

Below are a few screenshots of what you can expect there.

This is what you’ll see if you don’t have a license installed and select the Balsamiq option.

This is what you’ll see if you have installed a license you purchase via Atlassian Marketplace.

Note: An Atlassian Marketplace license, if installed, trumps any existing Balsamiq license.

If you receive an error when registering, this FAQ may help.


Selecting Balsamiq Wireframes Editors

If you purchased your app license via Atlassian Marketplace, all of your Jira users will be able to access the app.

If instead you purchased your app license from Balsamiq, depending on your Balsamiq Wireframes and Jira license levels, you might see different instructions on the app licensing page regarding who can create and edit new wireframes.

In short: if your app license is lower than your Jira license, you’ll have to create a Jira user group (by default called balsamiq-wireframes-editors) and add people to it manually, making sure that you don’t add more than what your app allows for. The rest of users in your Jira server instance, who are not part of the editor group, will be able to view wireframes, but will not be able to edit them.

You can customize the name of the Balsamiq Wireframes editors group in the app configuration page.


Updating Instructions

Installing via UPM automatically replaces the old app with the new version.

We follow Atlassian's Support End of Life Policy, meaning that as soon as Atlassian stops supporting a certain version of Jira, we'll update the app to stop supporting that version as well.

If you are running an old version of Jira, you can check compatibility and download older versions directly in Atlassian Marketplace for Wireframes for Jira Server.


Uninstalling Instructions

Uninstalling via UPM automatically removes all app modules from your Jira.

The wireframes project created with the app will NOT be deleted. They will just stay where they are as attachments to issues, but you will not be able to view or edit it.


Real Time Service Configuration

Balsamiq Wireframes for Jira Server uses a behind the firewall service in order to allow the real time collaboration, chat and other features.

The default configuration should works in most cases. If you encounter any issue, you can find find some useful hints on this page.


Troubleshooting

If You Get an Error When Trying to Save Large Wireframes

When saving large wireframes or importing big image files, you might get an error. This is due to the fact that Tomcat has a 2MB default to the maximum size of a POST request, which is what we use to save the Balsamiq project file and images.

The good news is that this default can be changed: just edit your $JIRA_HOME/conf/server.xml and set maxPostSize to a higher value. Restart Jira and you’ll be all set. Your Jira might even run faster because of it!

If you have any issue, please email us and we’ll do our best to help.