Using extension engine

Since 2.6, the plugin engine has been completely rewritten and improved.

Note : Be careful to download the plugin version compatible with the extension engine

Prerequisites for the extension engine

To use the extension engine, Python3 is required.

First, you need one python's package : scp. Install it with the command pip3.

On debian based systems :

sudo apt install python3-pip
sudo pip3 install scp

On redhat based systems :

yum install epel-release
yum update
yum install python34 python34-pip
sudo pip3 install scp


Installing a plugin on your server(s) occurs in 3 steps:

  1. Installation of the extension package on the Administration server's filesystem;
  2. Activation of the extension via the Administration console;
  3. Installation of the extension for the Communication server.

Once the plugin is installed on your server(s) you still have to deploy an agent-part on all your agents.

Plugin installation on filesystem

First download the extension here:

Github :


Plugin site :

Then, place the downloaded zip file in the extensions folder of your Administration server and unzip it.

The Administration server's extensions folder is /usr/share/ocsinventory-reports/ocsreports/extensions by default

You may delete the zip file after it is unzipped.

Plugin activation

Log into your Administration console and go to the "Extensions" tab.

Select the plugin and click on "Install".

OCS plugin installation onglet

OCS plugin installation

Logout and login for finish the web installation.

You can now proceed with the installation on your Communication server.

Scripted communication server installation

To install your plugin on the Communication server, the may be used.

On your Administration server, go to the /usr/share/ocsinventory-reports/ocsreports/tools folder, and execute the script with sudo:

sudo python3

Enter the path to your Administration server's extensions folder:

Where is the plugins location [/usr/share/ocsinventory-reports/ocsreports/extensions/]

Don't forget the last slash

After, the script will present you all the plugins that can be installed. Select the number of the plugin that you want to install:

[0] => plugin1
[1] => plugin2
[2] => plugin3

Now there are two specific cases:

  • OCS Comuunication server is on the same server.
  • OCS Communication server is on an other server.

In the case where your Communication server is on an another server, you need to enter the server's informations:

What is the host:
What is the username:
What is the password:

In both case, you will have to enter the path of your Communication server's configuration directory:

Where is the server location [/etc/ocsinventory-server]

The script will copy all the needed files into your Communication server's configuration directory.

Note : Don't forget to restart your Communication server's apache service after the installation has finished

Server installation without script

To install plugins without the script, log into your Communication server and go to the configuration directory (By default "/etc/ocsinventory-server/").

There, create a new directory into "perl/Apache/Ocsinventory/Plugins/" with the name of the plugin :

sudo mkdir /etc/ocsinventory-server/perl/Apache/Ocsinventory/Plugins/PluginName

Note : Don't forget to put the first letter in uppercase

Next, place the file inside.

sudo cp /etc/ocsinventory-server/perl/Apache/Ocsinventory/Plugins/PluginName/

Finally, place the plugin's configuration file into the "plugins/" folder.

sudo cp pluginname.conf /etc/ocsinventory-server/plugins/

Note : Don't forget to restart your Communication server's apache service after the installation has finished

Plugin deployment

Now that your Administration and Communication servers support your plugin, you need to deploy the agent part on you clients.

The plugin's agent part is usualy located in the agent subfolder of your plugin's zip file.

So, find this folder back and create a zip file containing all the files in this folder.

Then, create a deployment package with the Store action as explained in Deploying packages or executing commands on client hosts

Specify C:\Program Files (x86)\OCS Inventory Agent\Plugins as the path where the files need to be copied on the agents.