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

# Install Gantt

> This tutorial walks you through the complete installation of Nextedy GANTT on your Polarion server.

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

After completing this tutorial, you will have:

* The Gantt extension installed in your Polarion server's extensions directory
* A production or evaluation license in place
* The Polarion configuration cache cleared for clean extension loading
* A running Polarion server with the Gantt widget available in the widget picker

## Prerequisites

* **Polarion ALM** installed and accessible (administrator access required)
* **Server filesystem access** to the Polarion installation directory
* **Downloaded distribution** -- download `nextedy_gantt.zip` from [https://gantt.nextedy.com/download/](https://gantt.nextedy.com/download/)

<Warning>
  This installation requires a Polarion server restart. Plan for a brief maintenance window if this is a production environment.
</Warning>

## Installation Steps

### Step 1: Unpack the Distribution

Unzip the downloaded `nextedy_gantt.zip` file on your local machine or directly on the server.

```text theme={null}
unzip nextedy_gantt.zip
```

You should see a folder named `com.nextedy.polarion.gantt` containing the extension files.

### Step 2: Copy the Extension to Polarion

Copy the `com.nextedy.polarion.gantt` folder into your Polarion extensions directory:

```text theme={null}
POLARION_INSTALL_LOCATION/polarion/extensions/
```

After copying, the directory structure should look like:

```text theme={null}
POLARION_INSTALL_LOCATION/
  polarion/
    extensions/
      com.nextedy.polarion.gantt/    <-- new folder
```

### Step 3: Install the License File

If you have a production license, copy the `gantt_lic.json` file to the Polarion license directory:

```text theme={null}
[POLARION_INSTALL]/polarion/license/gantt_lic.json
```

Or you can add it later easily from the Administration UI.\
In this case, once Gantt is installed, go to Polarion Administration - Nextedy GANTT - License, and attach the license file.

<Note>
  If you do not have a production license, the extension runs in evaluation mode for 30 days. You can install the license later without reinstalling the extension.
</Note>

### Step 4: Clear the Configuration Cache

Delete the Polarion configuration cache directory:

```text theme={null}
[POLARION_INSTALL]/data/workspace/.config
```

<Warning>
  This step is required after every installation or update. The `.config` directory only holds plugin cache data and is automatically rebuilt on startup. Skipping this step is the most common cause of the Gantt widget not appearing after installation.
</Warning>

### Step 5: Restart the Polarion Server

Restart your Polarion server using your standard procedure (service restart, application server restart, etc.).

After the server starts, you should see the Gantt extension listed in the Polarion administration panel.

### Step 6: Verify the Installation

1. Open **Administration** and navigate to **Nextedy GANTT > Setup**. The Setup page confirms the extension installed successfully and shows the **Installed Version** alongside the **Latest Version** (for example, `26.6.2.202606151920`), with an up-to-date indicator when current. From here you can also open the **Changelog**, the plugin **Download Page**, and **Create Demo Project**.
2. As a quick functional check, open any Polarion wiki page (LivePage) in **Edit** mode, click **Add Widget**, and confirm the Gantt widgets appear in the picker -- **Work Items > Gantt (Work Items)** and **Plans > Gantt (Plans)** (they are also grouped under the **Nextedy** category).
3. Add a Gantt widget (or open a page that already has one); its footer displays the installed version, e.g. **Nextedy GANTT 26.6.2**.

To explore a ready-made chart, install the [demo project](/gantt/getting-started/demo-project).

## Installation Summary

| Step | Action                              | Verification                                                                                                  |
| ---- | ----------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| 1    | Unzip `nextedy_gantt.zip`           | `com.nextedy.polarion.gantt` folder exists                                                                    |
| 2    | Copy to `polarion/extensions/`      | Folder visible in extensions directory                                                                        |
| 3    | Copy license to `polarion/license/` | `gantt_lic.json` in license directory                                                                         |
| 4    | Delete `data/workspace/.config`     | Directory removed                                                                                             |
| 5    | Restart Polarion                    | Server starts without errors                                                                                  |
| 6    | Verify installation                 | **Administration > Nextedy GANTT > Setup** shows installed version; Gantt widgets appear in the widget picker |

## Troubleshooting

If you see a message indicating the Gantt widget is not available after installation, the most common cause is a missing cache clear. Follow these steps:

1. Stop the Polarion server
2. Delete `[POLARION_INSTALL]/data/workspace/.config`
3. Start the Polarion server

If the issue persists after clearing the cache, contact [Nextedy support](https://support.nextedy.com/support/tickets/new) with your server logs.

<Tip title="Quick Verification">
  After installation, the Gantt widget appears in the Polarion widget picker under **Work Items > Gantt (Work Items)** and **Plans > Gantt (Plans)**. If you do not see these entries, repeat Step 4 and restart.
</Tip>

## Next Steps

* [Explore the Demo Project](/gantt/getting-started/demo-project) -- install the pre-configured demo project to see a working Gantt chart
* [Set Up a Basic Gantt Chart](/gantt/getting-started/setup-basic-gantt) -- create your own Gantt widget from scratch
* [Licensing and User Access](/gantt/getting-started/licensing) -- configure user groups and manage licenses

<LastReviewed date="2026-07-07" />