Configuration SMTP par fournisseur
TimePick a besoin d'un serveur SMTP pour envoyer les liens de connexion (magic links), les invitations et les notifications aux membres. Cette fiche décrit comment configurer les fournisseurs SMTP les plus courants pour une association.
Le SMTP se configure à deux endroits possibles, qui se complètent :
- Variables
SMTP_*au premier démarrage du conteneur — pré-remplissent l'assistant de configuration et peuvent provisionner directement la base de données. Voir Variables d'environnement et Configuration initiale. - Panneau Paramètres → Serveur d'email, dans l'application elle-même, une fois le premier administrateur créé. C'est la méthode recommandée pour modifier la configuration SMTP après le déploiement initial — voir Paramètres in-app.
Quel que soit le point d'entrée, un bouton Tester la connexion envoie un email de test avant d'enregistrer la configuration. Il est fortement recommandé de l'utiliser systématiquement, en particulier pour les fournisseurs marqués « à confirmer » ci-dessous.
Pour aller plus loin
Cette fiche couvre uniquement la configuration technique (hôte, port, identifiants). Les réglages qui améliorent la délivrabilité des emails (SPF, DKIM, DMARC) sont traités dans Délivrabilité email.
Comment TimePick choisit son serveur SMTP
À chaque envoi d'email, TimePick résout sa configuration SMTP selon l'ordre de priorité suivant :
- Configuration en base de données (saisie via l'assistant de premier démarrage ou le panneau Paramètres → Serveur d'email) — toujours prioritaire si elle existe.
- Variables d'environnement
SMTP_*— utilisées uniquement pour provisionner la base au tout premier démarrage du conteneur ; sans effet ensuite. - MailHog (
127.0.0.1:1025, développement local uniquement) — utilisé en dernier recours si aucune des deux sources précédentes n'est disponible.
Mot de passe chiffré
Le mot de passe SMTP est chiffré en base de données (AES-256-GCM) à l'aide de la variable ENCRYPTION_KEY. Cette clé est indispensable au déchiffrement : en cas de perte, les paramètres SMTP devront être ressaisis depuis le panneau d'administration. Voir Variables d'environnement pour sa génération.
Quel fournisseur choisir ?
- Aucune solution SMTP existante, petit volume : Gmail est le plus rapide à mettre en place (compte gratuit déjà possédé par la plupart des administrateurs associatifs).
- Aucune solution SMTP existante, volume plus soutenu ou meilleure délivrabilité recherchée : Brevo, pensé pour l'emailing transactionnel.
- Domaine et boîtes email déjà hébergés chez OVH : réutiliser directement ces identifiants évite un compte supplémentaire.
- Développement local : MailHog, sans configuration.
Gmail
Gmail permet d'utiliser un compte Google gratuit comme serveur d'envoi.
Prérequis : validation en deux étapes
Gmail exige la validation en deux étapes (2FA) sur le compte Google avant de pouvoir créer un mot de passe d'application. Depuis mai 2022, Google bloque les connexions SMTP par mot de passe de compte classique — seul un mot de passe d'application fonctionne.
Procédure
- Activer la validation en deux étapes sur myaccount.google.com → Sécurité → Validation en deux étapes.
- Générer un mot de passe d'application sur myaccount.google.com/apppasswords (ou Sécurité → Validation en deux étapes → Mots de passe des applications si le lien direct ne fonctionne pas). Nommer l'application « TimePick » et copier immédiatement le mot de passe de 16 caractères généré — il ne sera plus jamais affiché.
- Dans TimePick (assistant de premier démarrage ou Paramètres → Serveur d'email), renseigner :
| Champ | Valeur |
|---|---|
| Hôte SMTP | smtp.gmail.com |
| Port SMTP | 587 (STARTTLS) ou 465 (SSL/TLS direct) |
| Connexion sécurisée | Désactivée pour le port 587, activée pour le port 465 |
| Utilisateur SMTP | L'adresse Gmail complète |
| Mot de passe SMTP | Le mot de passe d'application à 16 caractères |
| Email expéditeur | L'adresse Gmail utilisée |
Les deux combinaisons de port sont sécurisées ; le port 587 est la recommandation la plus courante.
- Cliquer sur Tester la connexion, puis vérifier la réception de l'email de test (y compris le dossier spam).
Réécriture de l'expéditeur
Google réécrit automatiquement l'en-tête From: pour qu'il corresponde à l'adresse Gmail authentifiée, quelle que soit la valeur saisie dans « Email expéditeur ». C'est une mesure anti-usurpation imposée par Google, pas un dysfonctionnement de TimePick : les destinataires verront toujours l'adresse Gmail comme expéditeur.
Limite du compte Gmail gratuit
Instantané juillet 2026, d'après la documentation technique du projet : environ 500 emails par jour et 500 destinataires par email. Largement suffisant pour un usage associatif courant, mais à surveiller si les envois groupés (invitations à un grand événement) approchent ce volume.
Fiabilité de ces informations
Ces paramètres n'ont pas été revérifiés avec un compte Gmail réel lors de la dernière vérification de l'instance de référence (juillet 2026). Utiliser systématiquement le bouton Tester la connexion avant de considérer la configuration comme opérationnelle.
Brevo
Brevo (anciennement Sendinblue) est un service de relais SMTP dédié à l'emailing, avec une bonne réputation de délivrabilité. Il convient bien à une association qui n'a pas encore de solution d'envoi d'emails.
- Créer un compte gratuit sur brevo.com.
- Dans le tableau de bord Brevo, aller dans SMTP & API, puis générer une clé SMTP.
- Dans TimePick, renseigner :
| Champ | Valeur |
|---|---|
| Hôte SMTP | smtp-relay.brevo.com |
| Port SMTP | 587 (STARTTLS) |
| Utilisateur SMTP | L'adresse email du compte Brevo |
| Mot de passe SMTP | La clé SMTP générée dans le dashboard — pas le mot de passe du compte Brevo |
À confirmer
Ces paramètres proviennent de la documentation de déploiement du projet et n'ont pas été testés avec un compte Brevo réel sur l'instance de référence (seul MailHog a été vérifié de bout en bout). Avant de considérer cette configuration comme fiable, créer un compte Brevo et utiliser le bouton Tester la connexion dans TimePick pour valider l'envoi effectif d'un email.
Limite du plan gratuit
Instantané juillet 2026 : le plan gratuit Brevo permet environ 300 emails par jour. Vérifier les conditions à jour sur le site de Brevo, ces plans évoluant régulièrement.
OVH
OVH convient à une association qui possède déjà un nom de domaine et des boîtes email chez cet hébergeur : les identifiants SMTP sont alors ceux de la boîte email existante, sans compte supplémentaire à créer.
| Champ | Valeur |
|---|---|
| Hôte SMTP | ssl0.ovh.net |
| Port SMTP | 465 (SSL) |
| Utilisateur SMTP | L'adresse email complète (ex. contact@votre-domaine.tld) |
| Mot de passe SMTP | Le mot de passe de cette boîte email |
| Email expéditeur | La même adresse que l'utilisateur SMTP |
À confirmer
Ces paramètres proviennent de la documentation de déploiement du projet et n'ont pas été testés avec une boîte email OVH réelle sur l'instance de référence. Avant de considérer cette configuration comme fiable, utiliser le bouton Tester la connexion dans TimePick avec les identifiants d'une boîte email OVH existante.
MailHog (développement uniquement)
En développement local, si aucun serveur SMTP n'est configuré, TimePick bascule automatiquement vers MailHog (127.0.0.1:1025) : ce comportement a été vérifié de bout en bout sur l'instance de référence. Les emails sont interceptés localement au lieu d'être réellement délivrés, ce qui permet de tester le flux d'authentification sans dépendre d'un vrai fournisseur.
MailHog n'a aucune utilité en production. Voir Installation locale pour son installation.
Dépannage courant
| Symptôme | Cause probable | Solution |
|---|---|---|
Invalid login / Authentication failed (Gmail) | Le mot de passe de compte Gmail habituel a été saisi | Utiliser exclusivement le mot de passe d'application à 16 caractères |
| L'option « Mots de passe des applications » n'apparaît pas sur Google | La validation en deux étapes n'est pas activée | Activer la validation en deux étapes avant de générer un mot de passe d'application |
Connection timeout | Le port SMTP (587 ou 465) est bloqué en sortie par l'hébergeur ou un pare-feu | Vérifier les règles de sortie réseau du serveur ou du VPS |
| Email de test jamais reçu | Configuration SMTP incorrecte, ou email tombé en spam | Vérifier le dossier spam du destinataire ; consulter les journaux serveur pour une erreur SMTP explicite |
| Erreur d'authentification chez Brevo | La clé SMTP a été confondue avec le mot de passe du compte Brevo | Régénérer une clé SMTP dédiée dans SMTP & API du dashboard Brevo |
| Erreur d'authentification chez OVH | Mot de passe de la boîte email incorrect ou expiré | Vérifier le mot de passe depuis l'espace client OVH, en le réinitialisant si nécessaire |
Alternatives pour la montée en charge
Au-delà des limites des offres gratuites ci-dessus, deux autres services d'emails transactionnels sont couramment utilisés et compatibles avec TimePick via SMTP standard, sans qu'aucun de leurs paramètres n'ait été testé sur l'instance de référence :
- Resend : service moderne orienté développeurs, avec une API et une intégration SMTP.
- Mailgun : service établi, avec un tier gratuit limité et une facturation à l'usage au-delà.
Récapitulatif
| Fournisseur | Hôte | Port | Sécurité | Limite indicative | Statut de vérification |
|---|---|---|---|---|---|
| Gmail | smtp.gmail.com | 587 ou 465 | STARTTLS (587) ou SSL (465) | ~500 emails/jour (juillet 2026) | Documentation projet dédiée, non revérifiée avec un compte réel |
| Brevo | smtp-relay.brevo.com | 587 | STARTTLS | ~300 emails/jour, plan gratuit (juillet 2026) | À confirmer — non testé sur l'instance de référence |
| OVH | ssl0.ovh.net | 465 | SSL | Dépend de l'offre d'hébergement | À confirmer — non testé sur l'instance de référence |
| MailHog | 127.0.0.1 | 1025 | aucune (interception locale) | sans objet (développement uniquement) | Vérifié de bout en bout sur l'instance de référence |
| Resend | — | — | — | — | Non documenté, non testé |
| Mailgun | — | — | — | — | Non documenté, non testé |