---
title: "Installation"
weight: 10
description: "Mise en place et activation du module ScanConnect dans Dolibarr."
---

# Installation

## Téléchargement

Le module ScanConnect est distribué sur le DoliStore et sur le site de CAP-REL. Vous pouvez aussi le retrouver sur la page produit du serveur OCR :

- DoliStore : recherchez `ScanConnect` dans le catalogue des modules.
- Site éditeur : [https://cap-rel.fr](https://cap-rel.fr).

## Installation depuis Dolibarr

ScanConnect s'installe comme tout module externe Dolibarr.

1. Connectez-vous à Dolibarr en tant qu'administrateur.
2. Rendez-vous dans **Accueil > Configuration > Modules/Applications**.
3. Cliquez sur l'onglet **Déployer/Installer un module externe**.
4. Sélectionnez le fichier `module_scanconnect-X.Y.Z.zip` que vous venez de télécharger.
5. Validez. Dolibarr extrait le module dans le dossier `custom/scanconnect`.

![Page d'installation d'un module externe dans Dolibarr](screenshots/installation-module-externe.webp)

## Activation

1. Dans la liste des modules disponibles, recherchez **ScanConnect** (catégorie *Technic*).
2. Cliquez sur l'interrupteur pour activer le module.
3. Si une extension PHP requise (`curl` ou `fileinfo`) manque, Dolibarr affiche un message d'erreur et l'activation est annulée. Demandez à votre hébergeur d'installer l'extension manquante puis recommencez.

![Activation du module ScanConnect dans la liste des modules](screenshots/activation-module.webp)

## Vérification post-installation

Une fois le module activé :

- L'icône d'engrenage (configuration) apparaît à côté du module.
- Cliquer dessus ouvre la page de configuration où vous renseignerez les paramètres du serveur OCR.

## Mise à jour

Pour mettre à jour ScanConnect vers une version plus récente :

1. Téléchargez la nouvelle archive du module.
2. Réinstallez-la via **Déployer/Installer un module externe** : Dolibarr écrase l'ancienne version.
3. **Désactivez** puis **réactivez** le module dans la liste des modules. Cette opération est indispensable : elle applique les éventuelles mises à jour de la base de données et enregistre les nouveaux droits ou hooks.

## Désinstallation

1. Dans **Accueil > Configuration > Modules/Applications**, désactivez le module ScanConnect.
2. Désactivez d'abord les modules qui en dépendent (ScanExpenses, ScanPay, ScanBank) si vous ne les utilisez plus.
3. Dolibarr supprime les paramètres et désenregistre les hooks. Les fichiers du module restent dans `custom/scanconnect`. Vous pouvez les supprimer manuellement après la désactivation si nécessaire.
