Chargement...

Installation

Documenos ®

Documenos® est compatible avec les architectures x86 et ARM.

Le processeur de votre serveur peut être basé sur x86 ou sur ARM. Documenos® est compatible avec les deux. Vous pouvez télécharger les fichiers d'installation adaptés à chaque architecture de serveur sur cette page : Télécharger

Deux modes d'installation sont possibles : avec Docker, tous les composants démarrent en une seule commande ; c'est la méthode recommandée. L'installation sur Windows IIS est à privilégier si vous souhaitez exécuter l'application sur votre infrastructure de serveurs Windows existante.

ARM / x86

Installation avec Docker

Un seul package installe ensemble l'application, la base de données PostgreSQL, le service de signature numérique, le moteur de recherche Elasticsearch et le service de traduction LibreTranslate.

  1. Préparez les prérequis. Docker Engine (20.10+) et le plug-in Docker Compose (2.0+) doivent être installés sur votre serveur. Au moins 8 GB RAM doivent pouvoir être alloués au conteneur de l'application, et le serveur doit disposer d'un accès Internet pour télécharger les images de conteneurs. Fonctionne sous Linux, Windows et macOS.
  2. Téléchargez le package. Téléchargez le package Docker Compose (ZIP) depuis la page Télécharger. Le package comprend docker-compose.yml, qui contient les définitions des services, .env, qui contient les valeurs de configuration, et readme.md, qui contient les notes d'installation. Copiez le dossier tel quel sur votre serveur.
  3. Définissez les mots de passe. Ouvrez le fichier .env et, avant de démarrer les conteneurs, remplacez impérativement ces deux valeurs par vos propres valeurs robustes et uniques : DB_PASSWORD (mot de passe de l'utilisateur de la base de données PostgreSQL) et DEFAULT_PWD (mot de passe initial attribué aux nouveaux utilisateurs ; ceux-ci doivent le modifier après leur première connexion). N'utilisez jamais de mot de passe d'exemple ou par défaut en production.
  4. Vérifiez les paramètres réseau et de ports. Vérifiez les valeurs *_BIND_IP et *_PORT. Par défaut, les services de base de données, de signature, de recherche et de traduction n'écoutent que sur 127.0.0.1 et ne sont pas accessibles depuis l'extérieur ; le seul port exposé est celui de l'application (APP_PORT, par défaut 8080). Si l'application se trouve derrière un répartiteur de charge ou un proxy inverse, renseignez la valeur CLIENT_IP_HEADER (par exemple X-Forwarded-For).
  5. Démarrez les services. Dans le dossier contenant le fichier docker-compose.yml, exécutez la commande suivante : docker compose up -d
  6. Attendez la fin du premier démarrage. Au premier démarrage, le service de traduction télécharge les modèles de langue définis par TRANSLATE_LOAD_ONLY ; cela prend 5 à 10 minutes avec une connexion normale et n'a lieu qu'une seule fois. Vous pouvez suivre la progression avec les commandes docker compose ps et docker compose logs -f documenos_translate. Le service affiche starting pendant le téléchargement et healthy lorsqu'il est prêt. Si votre connexion est lente, augmentez la valeur TRANSLATE_START_PERIOD.
  7. Ouvrez l'application. Ouvrez http://adresse-de-votre-serveur:8080 (ou la valeur APP_PORT que vous avez définie) dans votre navigateur, suivez les instructions du premier lancement pour créer le compte administrateur et enregistrez votre licence.

Mise à jour : Téléchargez le dernier package, reportez vos valeurs de configuration actuelles dans le nouveau fichier .env, puis exécutez docker compose pull suivi de docker compose up -d. Vos données sont conservées dans des volumes Docker nommés et ne sont affectées ni par les mises à jour ni par les redémarrages.

Installation sur Windows IIS

Documenos® est une application ASP.NET Core ; elle s'exécute sur IIS via le module ASP.NET Core.

  1. Préparez les prérequis. Activez le rôle IIS sur Windows Server et installez l'ASP.NET Core Hosting Bundle. Le Hosting Bundle doit être installé après IIS ; sinon, le module ASP.NET Core n'est pas enregistré dans IIS. Après l'installation, redémarrez IIS avec la commande iisreset.
  2. Préparez le serveur de base de données. Installez PostgreSQL (v15 ou ultérieure) ou donnez accès à un serveur PostgreSQL existant. Documenos® utilise des bases de données distinctes pour le noyau (DOCUMENOS_CORE), le reporting (DOCUMENOS_REPORT) et la reconnaissance faciale (DOCUMENOS_FACE).
  3. Préparez les services auxiliaires. Elasticsearch est nécessaire pour la recherche plein texte, le service de signature numérique pour la signature électronique et LibreTranslate pour la traduction automatique sur votre propre serveur. Exécutez ces services sur un serveur distinct à l'aide des définitions du package Docker et notez les adresses auxquelles l'application peut y accéder.
  4. Téléchargez le package ZIP. Téléchargez le package en saisissant votre clé de téléchargement dans la section Fichier ZIP pour Windows IIS de la page Télécharger.
  5. Extrayez les fichiers sur le serveur. Extrayez le contenu du ZIP dans le dossier réservé au site web, par exemple C:\inetpub\documenos.
  6. Configurez les paramètres de connexion. Dans le fichier appsettings.json du dossier de l'application, saisissez vos informations de connexion PostgreSQL (CnStrServer, CnStr, CnStrBI, CnStrFA) dans la section ConnectionStrings. Définissez également dans ce fichier les adresses des services de signature et de traduction (SignatureServiceUrl, TranslateServiceUrl). La connexion au serveur de recherche Elasticsearch se configure depuis le panneau d'administration après l'installation.
  7. Créez un pool d'applications. Dans le Gestionnaire des services IIS, ajoutez un nouveau pool d'applications (Application Pool) et définissez la version .NET CLR sur Aucun code managé (No Managed Code).
  8. Ajoutez le site web. Dans le Gestionnaire des services IIS, créez un nouveau site via Sites → Ajouter un site Web ; choisissez comme chemin d'accès physique le dossier où vous avez extrait les fichiers et comme pool d'applications celui que vous venez de créer. Définissez les liaisons (port, nom d'hôte) et, en production, attribuez un certificat SSL pour HTTPS.
  9. Accordez les autorisations sur le dossier. Accordez à l'identité IIS AppPool\<nom du pool> les droits de lecture et d'écriture sur le dossier de l'application. L'application écrit les journaux, les fichiers temporaires et les clés de protection des données sous cette identité.
  10. Démarrez et ouvrez le site. Démarrez le site et ouvrez dans votre navigateur l'adresse que vous avez définie. Le schéma de base de données est appliqué automatiquement au démarrage de l'application. Suivez les instructions du premier lancement pour créer le compte administrateur et enregistrez votre licence.

Mise à jour : Les étapes de mise à niveau d'une installation IIS sont décrites sur la page Maintenance et mises à jour. Pour en savoir plus sur l'enregistrement de licence et le mode d'essai, consultez la page Licences.