> ## Documentation Index
> Fetch the complete documentation index at: https://learn.nextedy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Deploy Nextedy MEDIAKIT on a Polarion server and apply its licence.

export const LastReviewed = ({date}) => {
  if (!date) return null;
  const formatted = new Date(`${date}T00:00:00Z`).toLocaleDateString("en-US", {
    year: "numeric",
    month: "long",
    day: "numeric",
    timeZone: "UTC"
  });
  return <p className="mt-10 text-sm text-gray-400 dark:text-zinc-500 not-prose">
      Last reviewed on {formatted}
    </p>;
};

## 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](/overview/resources/polarion-version-support)
* 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.

| Your Polarion version | Build to install    |
| --------------------- | ------------------- |
| 2512 and earlier      | the Tomcat 9 build  |
| 2606 and later        | the Tomcat 11 build |

Installing the wrong build leaves the plugin unable to start.

## Install

<Steps>
  <Step title="Stop Polarion">
    Stop the Polarion service before changing anything on disk.
  </Step>

  <Step title="Copy the plugin">
    Copy the `com.nextedy.polarion.media` folder from the distribution package into the `extensions` folder of your Polarion installation.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Clear the workspace configuration">
    Delete the `.config` folder from your Polarion data workspace.

    <Warning>
      **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.
    </Warning>
  </Step>

  <Step title="Start Polarion">
    Start the Polarion service and wait for it to finish initialising.
  </Step>
</Steps>

## 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

<Card title="Adding the Gallery" icon="images" href="/mediakit/getting-started/adding-the-gallery">
  Configure which work item types show the gallery.
</Card>

<LastReviewed date="2026-09-03" />