Balsamiq Wireframes for Confluence Server

Balsamiq Wireframes for Confluence Server Admin Guide

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

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

Usage instructions for the plugin are in the Balsamiq Wireframes for Confluence Server Introduction.


Installation Instructions

Like most Atlassian add-ons, Balsamiq Wireframes for Confluence is installed via Atlassian’s Universal Plugin Manager, or UPM.

To install the plugin, go to the Confluence Administration page, select “Find new add-ons” from the Add-ons panel and search for Balsamiq Wireframes for Confluence Server.

Click on “Free Trial” and accept the license agreement for Balsamiq Wireframes for Confluence Server to begin the installation and start your 30-days free trial.


Registration Instructions

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

To register the plugin, go to the Confluence Administration page. Select “Manage new add-ons” and search for Balsamiq Wireframes for Confluence Server.

If you have UPM v.2 and 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, you’ll either see a Configure button or a Configure link (depending on your UPM version). Click on it and follow the instructions on the configuration page to paste your License Information and see the status of your current installation.

If you have a Marketplace trial license installed, you might not see a Configure button at all. In this case, please delete your Marketplace License Key and hit update to make the Configure button re-appear. This will allow you to enter a Balsamiq-issued license instead.

Here 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 purchased via Atlassian Marketplace.

This is what you’ll see if you have a license you purchased from Balsamiq but select the Atlassian option.

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

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

Note: UPM still showing the plugin as “Unlicensed” or “Free Trial” after you install the Balsamiq-issued license? This FAQ is for you.

Selecting Balsamiq Wireframes Editors

Here are the instructions, depending on the type of license you own:

  • If you purchased your plugin license via Atlassian Marketplace

All of your Confluence users will be able to access the plugin.

  • If you purchased your plugin license from Balsamiq

If your plugin license is lower than your Confluence license, you’ll have to create a Confluence user group called balsamiq-wireframes-editors and add people to it manually.

You can add and remove users to/from this group whenever you like but please make sure that you don’t add more users than what your plugin license allows for or you will not be able to edit your wireframes.

If instead you bought an unlimited version of the plugin, everyone will be able to create and edit wireframes.


Updating Instructions

Installing via UPM automatically replaces the old plugin 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 Confluence, we’ll update the plugin to stop supporting that version as well.

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


Uninstalling Instructions

Uninstalling via UPM automatically removes all plugin modules from your Confluence.

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


Real Time Service Configuration

Balsamiq Wireframes for Confluence 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 $CONFLUENCE_HOME/conf/server.xml and set maxPostSize to a higher value. Restart Confluence and you’ll be all set. Your Confluence might even run faster because of it!

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



Edit this page