Introduction à Billion Mail et Docker

Billion Mail est une plateforme open source de marketing par email conçue pour simplifier la gestion des campagnes par les entreprises et les particuliers. Ce guide présente comment déployer rapidement cette solution en utilisant des conteneurs Docker, évitant ainsi les configurations manuelles complexes et permettant de se concentrer sur la création de campagnes efficaces.

Avantages du déploiement via Docker

• Cohérence des environnements : Garantit l'uniformité entre développement, test et production, éliminant les problèmes liés aux différences de configuration.
• Déploiement rapide : Met en place l'ensemble de la plateforme en quelques minutes, sans dépendances manuelles.
• Isolation des ressources : Les composants tels que Postfix, Dovecot et Rspamd fonctionnent dans des conteneurs séparés, améliorant la stabilité du système.
• Scalabilité facilitée : Permet d'ajuster le nombre d'instances en fonction des besoins en envoi d'emails.

Prérequis pour l'installation

Assurez que votre système satisfait aux conditions suivantes avant de commencer :

• Docker Engine (version 20.10.0 ou supérieure)
• Docker Compose (version v2.0 ou supérieure)
• Au moins 2 Go de RAM et 20 Go d'espace disque disponible
• Git installé

Vérifiez l'installation de Docker avec les commandes ci-dessous :

docker version
docker compose version

Récupération du code source de Billion Mail

Cloner le dépôt de Billion Mail sur votre serveur à l'aide de Git :

git clone https://gitcode.com/GitHub_Trending/bi/BillionMail.git
cd BillionMail

Configuration des variables d'environnement

Billion Mail utilise des variibles d'environnement pour sa configuration. Copiez et modifiez le fichier d'exemple :

cp .env.example .env
vim .env

Paramètres essentiels à définir dans le fichier .env :

• Informations de connexion à la base de données
• Identifiants de l'administrateur
• Configuration du domaine
• Paramètres liés à l'envoi d'emails

Lancement du cluster de conteneurs Docker

Utilisez Docker Compose pour démarrer tous les services de Billion Mail :

docker compose up --detach

Cette commande lance les composants principaux :

• Service core : Application principale de Billion Mail (Dockerfiles/core/)
• Service postfix : Serveur d'envoi d'emails (Dockerfiles/postfix/)
• Service dovecot : Serveur de réception d'emails (Dockerfiles/dovecot/)
• Service rspamd : Système anti-spam (Dockerfiles/rspamd/)

Vérifiez l'état des conteneurs avec :

docker compose ps

Validation de l'installation

Consultez les logs pour confirmer que tous les services fonctionnent correctement :

docker compose logs --follow

Un message tel que "Server started on port 8080" indique que le service core est opérationnel.

Accès à l'interface d'administration

Ouvrez un navigateur et accédez à l'adresse IP ou au nom de domaine de votre serveur. Connectez-vous avec les identifiants administrateur définis précédemment dans le fichier .env.

Logo de la plateforme Billion Mail, symbolisant une gestion efficace du marketing par email

Personnalisation des informations de marque

Lors de la première connexion, configurez les détails de votre marque :

1. Dans la barre de navigation, allez dans "Paramètres" > "Gestion des domaines"
2. Cliquez sur "Ajouter un domaine"
3. Renseignez les informations du domaine et les quotas
4. Validez pour générer automatiquement les éléments de marque

Interface de configuration des domaines dans Billion Mail, permettant de définir le domaine, les quotas et les informations de marque

Activation des fonctionnalités d'IA (optionnel)

Billion Mail intègre des options d'IA pour optimiser le contenu des emails et améliorer la délivrabilité :

1. Allez dans "Paramètres" > "Modèles d'IA"
2. Sélectionnez un fournisseur d'IA (comme OpenAI, Gemini ou Anthropic)
3. Entrez votre clé API et sauvegardez la configuration

Interface de configuration des modèles d'IA dans Billion Mail, avec support pour plusieurs fournisseurs

Utilisation de base de la plateforme

Après configuration, vous pouvez créer et gérer vos campagnes de marketing par email via une interface intuitive. Fonctionnalités clés disponibles :

• Gestion des contacts (core/api/contact/)
• Création de modèles d'emails (core/api/email_template/)
• Envoi groupé d'emails (core/api/batch_mail/)
• Suivi des campagnes (core/api/campaign/)

Résolution des problèmes courants

En cas de difficultés lors du déploiement, consultez le script install.sh du projet ou appliquez ces solutions :

• Échec du démarrage des conteneurs : Vérifiez les paramètres dans le fichier .env, surtout les informations de connexion à la base de données.
• Impossible d'accéder à l'interface web : Contrôlez les règles du pare-feu et assurez-vous que les ports 80/443 sont ouverts.
• Échec de l'envoi d'emails : Vérifiez la configuration DNS et les enregistrements SPF/DKIM.

Ressources complémentaires

Pour approfondir les fonctionnalités avancées de Billion Mail, consultez :

• Documantation du projet : README.md
• Documentation des API : core/api/
• Exemples de fichiers de configuration : conf/

Le déploiement via Docker permet de mettre en place rapidement une plateforme complète de marketing par email. En se concentrant sur la création de contenus pertinents, les utilisateurs peuvent gérer efficacement leurs campagnes, que ce soit pour des petites entreprises ou des professionnels du marketing.