> For the complete documentation index, see [llms.txt](https://nx.docs.scailable.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://nx.docs.scailable.net/ai-manager-v6.1.4/ai-manager-plugin/advanced-configuration/manual-plugin-installation.md).

# Manual Plugin Installation

## Plugin Installation

The Nx Meta Server version 6.1.1 and newer is packaged with the AI Manager Plugin, so a separate installation should not be necessary.

If the Mediaserver installation does not come with the plugin, refer to the [scripted installation](#scripted-installation) or [manual installation](#advanced-manual-installation).

The desktop client does not need a separate installation of the plugin.

## Scripted Installation

If your installation did not come with the AI Plugin, you can install it yourself.

The manual installation works on Linux based systems with a single command line script.

{% hint style="info" %}
Installing the AI Manager Plugin restarts the Mediaserver. This takes a couple of seconds, and the client reconnects automatically.
{% endhint %}

Open a terminal window on the device where you installed the Mediaserver and execute the following command to install the AI Manager plugin:

```bash
sudo bash -c "$(wget -q -O - https://artifactory.nxvms.dev/artifactory/nxai_open/NXAIPlugin/install.sh)"
```

This script downloads the latest plugin and places it in the appropriate plugin folder.

The installation detects device features and selects appropriate settings, which is sufficient for most users and devices. If customization is needed or the automatic installation fails, install the AI Manager manually.

## Re-installation or Updates

To update or reinstall the AI Manager Plugin, safely re-run the same command.

The install script removes the old version of the plugin before installing the new version.

Existing settings are stored and reused. Check the settings afterward, because new options may require changes. An example might be a new runtime that is available for your hardware.

## Advanced Manual Installation

{% tabs %}
{% tab title="Linux" %}
The plugin can be downloaded from the following link for x86 devices:

{% embed url="<https://artifactory.nxvms.dev/artifactory/nxai_open/NXAIPlugin/release/libnxai_plugin.so>" %}
Plugin download link x86\_64
{% endembed %}

You can also download an aarch64 version of the plugin for ARM64 based devices:

{% embed url="<https://artifactory.nxvms.dev/artifactory/nxai_open/NXAIPlugin/release/libnxai_plugin_aarch64.so>" %}
Plugin download link aarch64
{% endembed %}

Once downloaded, copy the plugin file to the appropriate plugins folder.

```bash
/opt/networkoptix-metavms/mediaserver/var/nx_ai_manager/libnxai_plugin.so
```

The folder and the plugin file should be named in this exact way. Rename the plugin file if necessary.

Make sure to give read and write permissions to the created directory so that the AI Plugin can create the files it needs by running:

<pre class="language-bash"><code class="lang-bash"><strong>sudo chmod -R 777 /opt/networkoptix-metavms/mediaserver/var/nx_ai_manager
</strong></code></pre>

Once installed, the Mediaserver must be [restarted](/ai-manager-v6.1.4/support-and-troubleshooting/troubleshooting/controlling-the-server-and-the-plugin.md) before the plugin is detected.
{% endtab %}

{% tab title="Windows" %}
On Windows, the plugin cannot be downloaded separately.

The plugin is installed on windows in the following location.

```bash
C:\Program Files\Network Optix\Nx Witness\MediaServer\plugins\nx_ai_manager_plugin
```

The installed Mediaserver path differs for each VMS variant, such as Nx Meta:

```bash
C:\Program Files\Network Optix\Nx Meta\MediaServer\plugins\nx_ai_manager_plugin
```

{% endtab %}
{% endtabs %}

## Verifying the Installation

Once the plugin file is in place and the Mediaserver has been restarted, open any camera's settings in the desktop client, navigate to the **Integrations** tab, and confirm that **AI Manager** appears in the plugin list.

<figure><img src="/files/dqedkCSteuKOAIgT6Dx7" alt="Camera Settings dialog with the Integrations tab selected, showing AI Manager listed in the left pane"><figcaption><p>AI Manager appears in the Integrations tab once the plugin file is installed and the server has been restarted</p></figcaption></figure>

## Customized Installation Path

The install path can be customized for testing purposes and manually started to see output. The AI Manager Plugin expects the AI Manager to be installed in the same folder. The Stop/Start commands in the AI Manager Plugin UI do not work if the AI Manager is installed elsewhere.