# Redmine Plugin

# Introduction

Plugin to manage tickets for your Redmine projects, you can create, edit or delete tickets from the terminal or from the PandoraFMS console.

# Compatibility matrix

<table border="1" id="bkmrk-sistemas-donde-se-ha" style="width: 776px;"><tbody><tr><td style="width: 241px;">**Systems where it has been tested**</td><td style="width: 535px;">CentOS 7, Fedora

</td></tr><tr><td style="width: 241px;">**Systems where it should work**</td><td style="width: 535px;">Any linux system

</td></tr></tbody></table>

# Pre requisites

Required:

- Enable rest web services in redmine
- **\*** Python3
- **\*** Module requests

**\* In the binary version of the plugin it is not necessary to install these dependencies, since they are already included in the plugin.**

# Configuration

Web service rest must be enabled to use the plugin as it communicates with the API.

[![image.png](https://pandorafms.com/guides/public/uploads/images/gallery/2025-07/scaled-1680-/fTgimage.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2025-07/fTgimage.png)

To get to this menu, click on administration, then on configuration and finally on authentication.

The API token can be seen in "my account":

[![image.png](https://pandorafms.com/guides/public/uploads/images/gallery/2025-07/scaled-1680-/2Qyimage.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2025-07/2Qyimage.png)

**\* Remember that to create tickets (even manually in redmine) you have to do some basic configuration, like creating a ticket type, status and priority, this can be done in the administration menu:**

[![image.png](https://pandorafms.com/guides/public/uploads/images/gallery/2025-07/scaled-1680-/prRimage.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2025-07/prRimage.png)

[![image.png](https://pandorafms.com/guides/public/uploads/images/gallery/2025-07/scaled-1680-/6pvimage.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2025-07/6pvimage.png)

[![image.png](https://pandorafms.com/guides/public/uploads/images/gallery/2025-07/scaled-1680-/9DGimage.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2025-07/9DGimage.png)

[![image.png](https://pandorafms.com/guides/public/uploads/images/gallery/2025-07/scaled-1680-/vQUimage.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2025-07/vQUimage.png)

# Parameters

**Parameters**

<table border="1" id="bkmrk-method--m-get%2Cpost%2Cp" style="height: 435px;"><tbody><tr style="height: 29px;"><td style="height: 29px; width: 114.188px;">Method</td><td style="height: 29px; width: 56.3594px;">-m</td><td style="height: 29px; width: 195.172px;">post,put o delete</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 114.188px;">host</td><td style="height: 29px; width: 56.3594px;">-i, --ip</td><td style="height: 29px; width: 195.172px;">site redmine</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 114.188px;">token</td><td style="height: 29px; width: 56.3594px;">-t </td><td style="height: 29px; width: 195.172px;">token API</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 114.188px;">project id</td><td style="height: 29px; width: 56.3594px;">-p</td><td style="height: 29px; width: 195.172px;">id project</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 114.188px;">ticket id</td><td style="height: 29px; width: 56.3594px;">-tid</td><td style="height: 29px; width: 195.172px;">ticket id</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 114.188px;">subject</td><td style="height: 29px; width: 56.3594px;">-s</td><td style="height: 29px; width: 195.172px;">subject</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 114.188px;">description</td><td style="height: 29px; width: 56.3594px;">-d</td><td style="height: 29px; width: 195.172px;">description</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 114.188px;">priority id</td><td style="height: 29px; width: 56.3594px;">-pi</td><td style="height: 29px; width: 195.172px;">priority</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 114.188px;">status id</td><td style="height: 29px; width: 56.3594px;">-st</td><td style="height: 29px; width: 195.172px;">state</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 114.188px;">assigned to id</td><td style="height: 29px; width: 56.3594px;">-a</td><td style="height: 29px; width: 195.172px;">allocation request</td></tr></tbody></table>

**Methods**

Get to list, post to create ticket, put to update ticket and delete to delete ticket.

# Create ticket

**Necessary arguments**

-m (post)

-i (host)

-t (token)

-p (project id)

-s (subject)

-d (description)

-pi (priority id)

-st (status id)

-a (asigned to id)

**Example manual execution**

```
./pandora_redmine -m post -i http://pandorap.m.redmine.org -t <token> -p 1 -s "this is the subject" -d "the description" -pi 1 -st 1 -a 1
```

The request will be created in our project.

[![Screenshot 2025-09-18 093043.png](https://pandorafms.com/guides/public/uploads/images/gallery/2025-09/scaled-1680-/screenshot-2025-09-18-093043.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2025-09/screenshot-2025-09-18-093043.png)

# Update ticket

**Necessary arguments**

-m (post)

-i (host)

-t (token)

-p (project id)

-tid (ticket id)

-s (subject)

-d (description)

-pi (priority id)

-st (status id)

-a (asigned to id)

**Example manual execution**

```
./pandora_redmine -m put -tid 1 -i http://pandorap.m.redmine.org -t <token> -p 1 -s "omg" -d "descripcion" -pi 1 -st 1 -a 1
```

The ticket with id #1 will be updated

[![remove_watermark_image_20250918_102411.png](https://pandorafms.com/guides/public/uploads/images/gallery/2025-09/scaled-1680-/remove-watermark-image-20250918-102411.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2025-09/remove-watermark-image-20250918-102411.png)

# Delete ticket

It will be eliminated by searching the request by id.

**Example manual execution:**

```
./pandora_redmine -m delete -tid 2 -i http://pandorap.m.redmine.org -t <token>
```

# Configuration in PandoraFMS

**Manual installation**

Go to servers &gt; plugins:

[![servers_plugins.png](https://pandorafms.com/guides/public/uploads/images/gallery/2025-07/scaled-1680-/servers-plugins.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2025-07/servers-plugins.png)

Click on add plugin:

[![add_plugin.png](https://pandorafms.com/guides/public/uploads/images/gallery/2025-07/scaled-1680-/add-plugin.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2025-07/add-plugin.png)

We put in name and the description that you prefer.

We put as command the execution with the path of the plugin:

```
/path pandora_redmine
```

<p class="callout info align-center">Remember that the recommended path for the use of the server plugins is: /usr/share/pandora\_server/util/plugin/</p>

We enter the path to the plugin as a command, and as parameters we will configure the “\_field\_” fields, which are macros that we will define below. Review the “create ticket,” “edit ticket,” and “delete ticket” sections to configure the parameters according to your needs.

Once this is done, click on “create”.

**Agent configuration**

Once this is done, the only thing left to do is to call it, so we will go to some agent's view and create an add-on module:

[![Captura desde 2025-07-21 11-51-43.png](https://pandorafms.com/guides/public/uploads/images/gallery/2025-07/scaled-1680-/captura-desde-2025-07-21-11-51-43.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2025-07/captura-desde-2025-07-21-11-51-43.png)

We will give it a name and in the section “plugin” we will put the one we have just configured.

Once this is done, click on create.

If the module is shown with 1, it means that it is running correctly.