---
title: "Installation"
weight: 10
description: "Téléchargement, installation, activation et mise à jour du module DoliSMTP."
---

# Installation

## Téléchargement

Téléchargez le module depuis le [DoliStore](https://www.dolistore.com/) ou depuis votre espace client sur [dolismtp.fr](https://dolismtp.fr).

## Installation du module

1. Décompressez l'archive téléchargée
2. Copiez le dossier `dolismtp` dans le répertoire `htdocs/custom/` de votre installation Dolibarr

La structure finale est : `htdocs/custom/dolismtp/`.

## Activation

1. Connectez-vous en tant qu'administrateur Dolibarr
2. Allez dans **Accueil > Configuration > Modules/Applications**
3. Recherchez "DoliSMTP" dans la liste des modules
4. Cliquez sur le bouton d'activation

![Page d'activation du module DoliSMTP dans la liste des modules Dolibarr](screenshots/activation-module.webp)

Le module crée automatiquement les tables nécessaires en base de données et enregistre une tâche cron de synchronisation des statuts email.

## Premier paramétrage

Après activation, rendez-vous dans **Accueil > Configuration > Modules > DoliSMTP** pour effectuer le paramétrage initial :

1. **URL de l'API** — L'adresse par défaut `https://dolismtp.fr/api` convient dans la majorité des cas
2. **Jeton API** — Saisissez le jeton d'authentification fourni par votre compte DoliSMTP
3. **Activer DoliSMTP** — Cochez cette option pour activer le routage des emails via DoliSMTP
4. Cliquez sur **Enregistrer**
5. Utilisez le bouton **Tester la connexion** pour vérifier que la communication avec l'API fonctionne

![Page de configuration initiale avec le jeton API et le test de connexion](screenshots/premier-parametrage.webp)

> **Attention** : Tant que le jeton API n'est pas renseigné, le module affiche un avertissement et les emails continuent d'être envoyés via la méthode par défaut de Dolibarr.

## Permissions

Le module ajoute plusieurs permissions à configurer pour vos utilisateurs dans **Accueil > Configuration > Utilisateurs & Groupes** :

| Permission | Description |
|------------|-------------|
| Lire les emails envoyés (les siens) | Permet de consulter ses propres emails |
| Lire tous les emails envoyés | Permet de consulter les emails de tous les utilisateurs |
| Gérer les boîtes mail | Permet de créer, modifier et supprimer des boîtes mail |
| Gérer les domaines | Permet d'ajouter et supprimer des domaines |
| Configurer le module | Accès à la page de configuration |
| Accès revendeur | Accès aux fonctionnalités de gestion des sous-comptes |

## Mise à jour

1. Remplacez le dossier `dolismtp` par la nouvelle version
2. Reconnectez-vous à Dolibarr : les mises à jour de base de données sont appliquées automatiquement