Skip to main content

What You Will Achieve

By the end of this tutorial the Mediakit plugin will be running on your Polarion server, ready to be added to work item forms.

Prerequisites

  • A running Polarion server with a version still supported by Nextedy
  • Java 17, which the current Mediakit release requires
  • Administrator access to the Polarion server filesystem, and permission to restart the Polarion service
  • The Mediakit distribution package and, for production use, a licence file

Choose the Right Build

Mediakit ships two builds from the same codebase. They differ only in the servlet API they are compiled against, so pick the one matching your Polarion version. Installing the wrong build leaves the plugin unable to start.

Install

1

Stop Polarion

Stop the Polarion service before changing anything on disk.
2

Copy the plugin

Copy the com.nextedy.polarion.media folder from the distribution package into the extensions folder of your Polarion installation.
3

Add the licence file

If you have a production licence, copy mediakit_lic.json into the license folder of your Polarion installation. A 30-day evaluation licence is included in the download, so you can skip this step while evaluating.
4

Clear the workspace configuration

Delete the .config folder from your Polarion data workspace.
Do not skip this step.Polarion caches its plugin configuration here. If the folder is left in place the server frequently starts without loading the Mediakit web application, and the gallery then fails to appear with no error to explain why.
5

Start Polarion

Start the Polarion service and wait for it to finish initialising.

Keep It Current

Install the latest release — currently 26.8.0. It is a security maintenance update: it refreshes the third-party libraries bundled with the plugin to address known vulnerabilities, and changes nothing else — no features, settings, or behaviour differ from the release before it. This matters in practice. Organisations that run vulnerability scanners across their Polarion installation will flag the older bundled libraries in earlier builds, so staying current avoids a finding that has already been fixed.

Next Steps

Adding the Gallery

Configure which work item types show the gallery.
Last modified on September 7, 2026