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

# Installation

## Téléchargement

Procurez-vous le module Capmail auprès de [CAP-REL](https://cap-rel.fr/contact/).

## Installation du module

1. Rendez-vous dans **Accueil > Configuration > Modules/Applications > Déployer/Installer un module externe**.
2. Sélectionnez le fichier zip du module et cliquez sur **Envoyer**.
3. Dolibarr installe automatiquement les fichiers dans le répertoire approprié.

![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 "Capmail" dans la liste des modules.
3. Cliquez sur l'interrupteur pour activer le module.

Une fois activé, le module crée automatiquement les tables nécessaires dans la base de données et enregistre ses permissions et menus.

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

## Vérification post-installation

Après activation, vérifiez que :

- Le menu **Outils > Capmail** apparaît dans le menu latéral gauche.
- La page de configuration est accessible via l'icône d'engrenage à côté du module, ou via **Outils > Capmail > Configuration**.
- L'onglet "Capmail" apparaît sur les fiches tiers.

## Mise à jour

Pour mettre à jour le module vers une nouvelle version :

1. Rendez-vous dans **Accueil > Configuration > Modules/Applications > Déployer/Installer un module externe**.
2. Envoyez le nouveau fichier zip (il remplace les fichiers existants).
3. **Désactivez puis réactivez le module** pour appliquer les mises à jour de base de données et enregistrer les nouveaux hooks et permissions.

> **Attention :** l'étape de désactivation/réactivation est indispensable pour que les nouvelles colonnes, permissions et menus soient correctement enregistrés.

## Désinstallation

Pour désinstaller le module, désactivez-le depuis **Accueil > Configuration > Modules/Applications**. Les données (emails, pièces jointes) restent en base de données et sur le disque. Si vous réactivez le module ultérieurement, vous retrouverez vos données.