Maîtriser la personnalisation des modèles d'e-mails dans les déploiements d'applications Production Appwrite

Exécuter Appwrite en environnement de production—en particulier lorsqu’il est déployé via des plateformes gérées comme Digital Ocean Marketplace—nécessite souvent d’adapter les modèles d’e-mails pour refléter l’identité de votre marque. Ce guide complet vous accompagne dans la mise en œuvre de personnalisations persistantes à l’aide de montages de volumes Docker, garantissant que vos modifications survivent aux mises à jour de version et aux événements du cycle de vie des conteneurs.

Comment fonctionne l’infrastructure email d’Appwrite

Le système d’e-mail alimentant Appwrite repose sur deux couches interconnectées :

Couche des modèles (Fichiers TPL) : fichiers HTML responsables de la structure des e-mails, stockés dans /usr/src/code/app/config/locale/templates/

Couche de localisation (Fichiers JSON) : contenu textuel et traductions organisés par langue, situés dans /usr/src/code/app/config/locale/translations/

La plateforme inclut plusieurs modèles préconfigurés :

• email-magic-url.tpl – Messages d’authentification sans mot de passe
• email-inner-base.tpl – Communications de récupération de compte
• email-otp.tpl – Codes de vérification à usage unique
• email-mfa-challenge.tpl – Invitations à l’authentification multi-facteurs
• email-session-alert.tpl – Notifications d’activité de connexion

Pourquoi l’édition directe du conteneur échoue en production

Les distributions Appwrite préconstruites empaquettent tout dans des conteneurs Docker. Tenter de modifier directement les fichiers de modèles à l’intérieur des conteneurs en fonctionnement pose un problème critique : toutes les modifications disparaissent chaque fois que vous :

• Mettez à jour Appwrite vers une version plus récente
• Redémarrez ou recréez des instances de conteneurs
• Faites évoluer votre infrastructure horizontalement
• Effectuez des opérations de maintenance

Réaliser une personnalisation persistante avec des montages de volumes

Les montages de volumes Docker offrent la solution en superposant vos fichiers personnalisés sur les répertoires du conteneur, tout en les maintenant sur le système de fichiers hôte—totalement séparé du cycle de vie du conteneur.

Mise en place de la personnalisation des modèles d’e-mails : une approche pratique

Configuration initiale du serveur

Commencez par établir une connexion SSH à votre infrastructure :