Overview

Analytics plugins for the Media Server are stored in two folders. To disable a plugin, you move it from the active plugins folder to the inactive (optional) folder, then restart the Media Server service. The plugin will no longer be loaded on the next start.

Plugin Folder Locations

The active plugins folder (loaded on startup):

• Linux: /opt/networkoptix/mediaserver/bin/plugins
• Windows: C:\Program Files\Network Optix\Nx Witness\MediaServer\plugins

The inactive plugins folder (not loaded on startup):

• Linux: /opt/networkoptix/mediaserver/bin/plugins_optional
• Windows: C:\Program Files\Network Optix\Nx Witness\MediaServer\plugins_optional

Steps to Disable a Plugin

Windows

1. Open File Explorer and navigate to the active plugins folder: 
   C:\Program Files\Network Optix\Nx Witness\MediaServer\plugins
2. Locate the plugin file (.dll) or folder you want to disable.
3. Cut (Ctrl+X from the active plugins folder: 
   C:\Program Files\Network Optix\Nx Witness\MediaServer\plugins
4. Paste (Ctrl+V), the file to the inactive folder: 
   C:\Program Files\Network Optix\Nx Witness\MediaServer\plugins_optional
5. Restart the Media Server service: open Task Manager (Ctrl+Shift+Esc), go to the Services tab, find networkoptix-mediaserver, right-click it and select Stop, then right-click again and select Start.

Linux

To disable a plugin file: 

1. Open the terminal (Ctrl+Alt+T).
2. Move the plugin file to the inactive folder (replace <plugin_name.so> with the actual filename): 
   sudo mv /opt/networkoptix/mediaserver/bin/plugins/<plugin_name.so> /opt/networkoptix/mediaserver/bin/plugins_optional/
3. Restart the Media Server service: 
   sudo systemctl restart networkoptix-mediaserver.service

To disable a plugin folder: 

4. Open the terminal (Ctrl+Alt+T).
5. Move the plugin file to the inactive folder (replace <foldername> with the actual filename): 
   sudo mv /opt/networkoptix/mediaserver/bin/plugins/<foldername> /opt/networkoptix/mediaserver/bin/plugins_optional/
6. Restart the Media Server service: 
   sudo systemctl restart networkoptix-mediaserver.service

Re-enabling a Plugin

To re-enable a plugin, reverse the process: move the file or folder from plugins_optional back to plugins, then restart the Media Server service as described above.

Notes

• Administrator/sudo privileges are required to move files in the Media Server installation directory and to restart the service.
• The plugins_optional folder is not monitored by the Media Server. Files stored there will not load unless manually moved back.
• A service restart is always required after moving a plugin, changes do not take effect while the service is running.
• On Windows, if File Explorer prompts for administrator confirmation, click Continue or run File Explorer as Administrator.