# Installation

## Prérequis

Afin de procéder à l'installation d'**Open-Capture For MEM**, il est recommandé d'utiliser la distribution Debian. Cependant, il reste possible d'utiliser les distributions Ubuntu et Ubuntu Server mais le support au niveau des bugs ne sera pas possible. De plus, les versions des paquets peuvent différer entre les distributions.

Vous trouverez ci-dessous un tableau des versions **Python** & **Tesseract** ainsi que des distributions testées et recommandées pour l'installation d'**Open-Capture For MEM**.

| Python | Tesseract | Système d'exploitation |
| ------ | --------- | ---------------------- |
| >= 3.9 | >= 5.2.0  | Debian >= 12           |

## Clonage du dépôt git

C'est parti pour l'installation. Il n'y a rien de plus simple, vous n'avez qu'à taper les commandes suivantes. Ces dernières permettront :

* La création du dossier **Open-Capture For MEM**
* La mise en place des bons droits sur ce dossier
* L'installation de Git
* La récupération du dernier tag

```bash
sudo mkdir -p /opt/edissyum/
sudo chmod -R 775 /opt/edissyum/
sudo chown -R $(whoami):$(whoami) /opt/edissyum/
sudo apt install git
latest_tag=$(git ls-remote --tags --sort="v:refname" https://github.com/edissyum/opencaptureformem.git | tail -n1 | sed 's/.*\///; s/\^{}//')
git clone -b $latest_tag https://github.com/edissyum/opencaptureformem /opt/edissyum/opencaptureformem/
cd /opt/edissyum/opencaptureformem/install/
chmod u+x install.sh
```

## Lancement de l'installateur

Vous êtes désormais prêt à installer tout le nécessaire pour faire fonctionner **Open-Capture For MEM**. Rien de bien compliqué, il vous suffira de quelques commandes seulement. Durant l'installation, vous aurez le choix entre l'utilisation de [**systemd**](https://doc.ubuntu-fr.org/systemd) ou de [**supervisor**](https://doc.ubuntu-fr.org/systemd).

Par défaut, c'est **systemd** qui sera choisi, offrant un traitement des documents un par un. De son côté, **supervisor** permettra de lancer en simultané X instances d'**Open-Capture For MEM**. Attention, si vous choisissez **supervisor**, la configuration de la machine devra suivre au niveau des performances.

{% hint style="warning" %}
Merci de ne pas lancer l'installateur avec l'utilisateur `root`. Il faut créer un utilisateur spécifique si aucun n'est déjà présent et lancer l'installateur en `sudo`.
{% endhint %}

```bash
sudo ./install.sh
```

Si vous le souhaitez, il est possible de spécifier certains paramètres en argument de l'installateur. La liste est disponible ci-dessous : 

```bash
--user : Forcer un utilisateur en particulier (facultatif)
--supervisor_systemd : Utilisation de supervisor ou systemd (facultatif)
--supervisor_process : Nombre de processessus supervisor (facultatif)
--path : Chemin contenant le code Open-Capture For MEM (facultatif)
--secure_rabbit : Activer la sécurisation de RabbitMQ, le gestionnaire de file d'attente (facultatif)
--rabbit_user : Nom du nouvel utilisateur RabbitMQ (facultatif)
--rabbit_password : Mot de passe du nouvel utilisateur RabbitMQ (facultatif)
--rabbit_host : Nom du nouvel hôte RabbitMQ (facultatif)
--rabbit_port : Port du nouvel hôte RabbitMQ (facultatif)
--rabbit_vhost : Nom du nouvel hôte virtuel RabbitMQ (facultatif)
```

{% hint style="warning" %}
Veillez à bien vérifier que les paramètres correspondent bien à votre installation. Notamment au niveau de l'utilisateur bash (`--user`)
{% endhint %}

```bash
sudo ./install.sh \
 --user edissyum \
 --path /opt/edissyum/opencaptureformem/ \
 --supervisor_systemd systemd \
 --secure_rabbit true \
 --rabbit_user edissyum \
 --rabbit_password edissyum \
 --rabbit_port 5672 \
 --rabbit_vhost opencaptureformem
```

Si jamais vous souhaitez utiliser une langue d'OCR différente du français ou de l'anglais, il vous sera possible de télécharger les paquets supplémentaires de Tesseract. Pour cela, il vous suffit d'aller [**sur le site suivant**](https://www.macports.org/ports.php?by=name\&substr=tesseract-) et de récupérer le code de langue situé après le `-`. Lancez ensuite la commande suivante :

```bash
sudo apt install tesseract-ocr-<langcode>
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://edissyum.gitbook.io/open-capture-for-mem/technique/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.