đź“–
Open-Capture Documentation
  • 🏠Accueil
  • 🖥️Technique
    • Installation
      • CrĂ©ation d'instances supplĂ©mentaires
      • ParamĂ©trage d'un partage Samba
      • RĂ©cupĂ©ration des fournisseurs
      • Capture de mail
      • Mise en place des scripts de purge
    • Architecture fonctionnelle
    • Mise Ă  jour
    • Ajout d'une nouvelle langue
    • Connexion sans login/mdp depuis une application externe
    • DĂ©veloppement custom
    • Gestion des erreurs
    • Web Services
      • Authentification
      • Comptes tiers et clients
      • Configurations
      • Champs personnalisĂ©s
      • Formulaires
      • Module VĂ©rificateur
      • Pièces jointes
      • Monitoring
  • 🛠️ParamĂ©trages
    • Statistiques
    • Monitoring des processus
    • Liste des comptes clients
    • Liste des comptes fournisseurs
    • Historique
    • Paramètres GĂ©nĂ©raux
      • A propos
      • Configurations
      • Zone de stockage
      • Liste des Regex
      • MailCollect
      • Liste des utilisateurs
      • Quota d'utilisateurs
      • Liste des rĂ´les
        • Privilèges des rĂ´les
      • Champs personnalisĂ©s
      • MĂ©thodes d'authentification
    • Paramètres VĂ©rificateur
      • ParamĂ©trages divers
      • Workflows
        • Exemples de scriptings
      • RĂ©cupĂ©ration du contact
      • Liste des Formulaires
        • Modification du formulaire
        • CrĂ©ation de formulaire
      • ChaĂ®nes sortantes
        • Export XML
        • Export MEM Courrier
        • Export PDF
      • Masques de positionnement
        • CrĂ©er un nouveau masque
        • Modification du masque
    • Paramètres Splitter
      • Workflows
      • Liste des Formulaires
        • Modification du formulaire
        • CrĂ©ation de formulaire
      • ChaĂ®nes sortantes
        • Export PDF
        • Export XML
        • Export CMIS
        • Export OpenADS
      • SĂ©parateurs de documents
      • Types de documents
        • Ajouter un type de document
        • Ajouter une chemise
      • Intelligence artificielle
      • Changement de statut
  • 📝Utilisation
    • Introduction
    • Mot de passe oubliĂ©
    • VĂ©rifier
    • Splitter
    • TĂ©lĂ©charger le lot factures d’essai
    • TĂ©lĂ©charger le lot documents RH
Powered by GitBook
On this page
  • PrĂ©requis
  • Clonage du dĂ©pĂ´t git
  • Lancement de l'installateur
  • Accès Ă  votre installation
  1. Technique

Installation

Prérequis

Afin de procéder à l'installation d'Open-Capture, 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.

Python
Tesseract
Système d'exploitation

>= 3.9

>= 5.2.0

Debian >= 11

Pour la partie utilisation client, il est recommandé d'utiliser le navigateur Firefox. Chrome et Edge fonctionnent malgré tout, mais toutes les fonctionnalités ne sont pas garanties.

Minimum
Recommandé
Recommande (IA)

Processeur

4 vCPU

4 vCPU

8 vCPU

Mémoire vive

8Go (+4Go de SWAP)

12Go (+6Go de SWAP)

16Go (+8Go de SWAP)

Stockage

60 Go

60 Go

80 Go

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

  • La mise en place des bons droits sur ce dossier

  • L'installation de Git

  • La rĂ©cupĂ©ration du dernier tag

sudo mkdir -p /var/www/html/opencapture/
sudo chmod -R 775 /var/www/html/opencapture/
sudo chown -R $(whoami):$(whoami) /var/www/html/opencapture/
sudo apt install -y git crudini
latest_tag=$(git ls-remote --tags --sort="v:refname" https://github.com/edissyum/opencapture.git | tail -n1 |  sed 's/.*\///; s/\^{}//' | grep -E '3.+([0-9])$')
git clone -b $latest_tag https://github.com/edissyum/opencapture/ /var/www/html/opencapture/
cd /var/www/html/opencapture/install/

Lancement de l'installateur

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

Le paramètre `-c` permet de spécifier le nom du custom (où seront stockés vos différents paramètres). Par défaut, nous le mettons à "edissyum". Si vous souhaitez le changer, modifier le libellé dans la commande ci-dessous (éviter les espaces, accents et autres caractères spéciaux). À noter que si vous souhaitez installer Open-Capture sur un serveur accessible depuis l'extérieur, le custom peut prendre le nom de votre nom de domaine. (Exemple d'une commande pour l'instance https://demo.open-capture.com/ : sudo ./install.sh -c demo.open-capture.com)

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.

Si votre custom contient des . ou des -, l'application remplacera ces caractères par des _. Ne vous inquiétez pas, l'utilisation du nom du custom dans l'URL restera avec les caractères d'origines.

sudo ./install.sh --custom_id edissyum

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

--user : Forcer un utilisateur en particulier (facultatif)
--custom_id : Identifiant du custom (obligatoire)
--supervisor_systemd : Utilisation de supervisor ou systemd (facultatif)
--supervisor_process : Nombre de processessus supervisor (facultatif)
--path : Chemin contenant le code Open-Capture (facultatif)
--docserver_path : Chemin des docservers (stockage des documents) (facultatif)
--share_path : Chemin de partage (contenant les dossiers imports / exports) (facultatif)
--python_venv_path : Chemin du venv Python (facultatif)
--wsgi_threads : Nombre de threads WSGI (facultatif)
--wsgi_process : Nombre de process WSGI (facultatif)
--database_name : Nom de la base de données (facultatif)
--database_hostname : Hôte de la base de données (facultatif)
--database_port : Port de la base de données (facultatif)
--database_username : Utilisateur de la base de données (facultatif)
--database_password : Mot de passe de l'utilisateur de base de données (facultatif)

Ci-dessous un exemple complet avec les différentes options remplies.

Veillez à bien vérifier que les paramètres correspondent bien à votre installation. Notamment au niveau de l'utilisateur bash (--user), de l'utilisateur postgresql (--username et --password) et des différents chemins (--docserver_path, --path ou encore --python-venv-path)

sudo ./install.sh \
 --user edissyum \
 --custom_id edissyum \
 --path /var/www/html/opencapture/ \
 --share_path /var/share/ \
 --docserver_path /var/docservers/opencapture/ \
 --python_venv_path /home/edissyum/python-venv/opencapture/ \
 --wsgi_process 1 \
 --wsgi_threads 5 \
 --supervisor_systemd systemd \
 --database_hostname localhost \
 --database_port 5432 \
 --database_username edissyum \
 --database_password edissyum

Vous pouvez suivre l'avancée de l'installation, et les éventuelles erreurs, avec les deux commandes suivantes

tail -f /var/www/html/opencapture/install/install_info.log
tail -f /var/www/html/opencapture/install/install_error.log
sudo apt install tesseract-ocr-<langcode>

Accès à votre installation

Sur une installation classique comme ici, vous pourrez directement accéder à votre instance via l'adresse IP de votre serveur (ou nom de domaine).

Exemple : http://192.168.10.10/edissyum/dist/

Notez bien la présence d'un nom de l'instance edissyum dans l'URL, ceci est indispensable.

PreviousAccueilNextCréation d'instances supplémentaires

Last updated 8 days ago

Vous êtes désormais prêt à installer tout le nécessaire pour faire fonctionner Open-Capture. Rien de bien compliqué, il vous suffira de quelques commandes seulement. Durant l'installation, vous aurez le choix entre l'utilisation de ou de .

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 et de récupérer le code de langue situé après le -. Lancez ensuite la commande suivante :

🖥️
systemd
supervisor
sur le site suivant