---
title: "Installation"
weight: 10
description: "Guide d'installation, d'activation et de mise à jour du module tpeConnect."
---

# Installation

## Téléchargement

Le module tpeConnect est disponible sur le DoliStore. Rendez-vous sur la fiche du module pour télécharger la dernière version.

## Installation du module

1. Connectez-vous à votre Dolibarr en tant qu'administrateur.
2. Rendez-vous dans **Accueil > Configuration > Modules/Applications > Déployer/Installer un module externe**.
3. Sélectionnez le fichier ZIP téléchargé et validez.

![Page de déploiement d'un module externe dans Dolibarr](screenshots/deploiement-module.webp)

## Activation

1. Rendez-vous dans **Accueil > Configuration > Modules/Applications**.
2. Recherchez "tpeConnect" dans la liste des modules.
3. Cliquez sur l'interrupteur pour activer le module.

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

Une fois le module activé, l'icône d'engrenage à droite vous donne accès à la configuration.

## Installation de l'agent logiciel

Le module nécessite un **agent logiciel** installé sur chaque poste de caisse. Cet agent fait le relais entre votre navigateur et le terminal de paiement.

1. Après activation du module, rendez-vous dans la page de configuration, onglet **Agent logiciel**.
2. Téléchargez la version correspondant à votre système d'exploitation :
   - **Windows** 64 bits
   - **macOS** 64 bits
   - **Linux** 64 bits
   - **Raspberry Pi** arm64
3. Placez l'exécutable dans un dossier de votre choix sur le poste de caisse.
4. Téléchargez le fichier de configuration correspondant à votre TPE (bouton **Télécharger la configuration**).
5. Placez le fichier de configuration dans le même dossier que l'agent.

![Page de téléchargement de l'agent logiciel avec les liens pour chaque système](screenshots/configuration-agent-logiciel.webp)

## Vérification post-installation

1. Lancez l'agent logiciel sur le poste de caisse.
2. L'agent vérifie automatiquement que le TPE est joignable sur le réseau.
3. Si la connexion est établie, l'agent affiche un message de confirmation.

![L'agent logiciel vérifie que le TPE est joignable au lancement, exemple sans erreur](screenshots/agent-logiciel-sans-erreur.webp)

Si le TPE n'est pas joignable, un message d'erreur s'affiche avec le détail du problème.

![L'agent logiciel vérifie que le TPE est joignable au lancement, exemple d'erreur](screenshots/agent-logiciel-erreur.webp)

![L'agent logiciel en version macOS](screenshots/agent-logiciel-macos.webp)

## Mise à jour

1. Téléchargez la nouvelle version du module sur le DoliStore.
2. Installez-la via **Accueil > Configuration > Modules/Applications > Déployer/Installer un module externe**.
3. **Désactivez puis réactivez** le module pour appliquer les mises à jour de base de données et enregistrer les nouveaux hooks.

> **Attention :** pensez également à mettre à jour l'agent logiciel si une nouvelle version est disponible.

## Désinstallation

Pour désinstaller le module, rendez-vous dans **Accueil > Configuration > Modules/Applications**, recherchez "tpeConnect" et cliquez sur l'interrupteur pour le désactiver.