Configuration Email

Configurer SMTP pour la réinitialisation de mot de passe et la vérification d'email.

Configuration Email

DBKeep utilise un serveur SMTP pour envoyer des emails. Cette configuration est optionnelle mais requise pour :

  • Réinitialisation de mot de passe ("Mot de passe oublié")
  • Vérification d'email à l'inscription (optionnel)

Variables d'environnement

Ajoutez ces variables à votre fichier .env :

# Serveur SMTP
SMTP_HOST=smtp-relay.brevo.com
SMTP_PORT=587
SMTP_USER=votre-email@exemple.com
SMTP_PASSWORD=votre-clé-smtp
SMTP_SECURE=false

# Adresse d'expéditeur
EMAIL_FROM="DBKeep <noreply@votredomaine.com>"

# URL publique de l'application (pour les liens dans les emails)
NUXT_PUBLIC_APP_URL=https://votredomaine.com

Détail des variables

VariableDescriptionExemple
SMTP_HOSTHôte du serveur SMTPsmtp-relay.brevo.com
SMTP_PORTPort SMTP (587 pour TLS, 465 pour SSL)587
SMTP_USERNom d'utilisateur SMTPuser@exemple.com
SMTP_PASSWORDMot de passe ou clé API SMTPxkeysib-xxx
SMTP_SECUREtrue pour SSL (465), false pour TLS (587)false
EMAIL_FROMAdresse d'expéditeur avec nom"DBKeep <noreply@dbkeep.io>"

Vérification d'email à l'inscription

Par défaut, la vérification d'email est désactivée. Les utilisateurs peuvent se connecter immédiatement après inscription.

Pour exiger la vérification d'email avant la première connexion, ajoutez :

REQUIRE_EMAIL_VERIFICATION=true
ValeurComportement
false (défaut)Inscription sans vérification, connexion immédiate
trueUn email de vérification est envoyé, l'utilisateur doit cliquer sur le lien avant de pouvoir se connecter

Note : Cette option nécessite une configuration SMTP fonctionnelle.

Configuration par fournisseur

Brevo (anciennement Sendinblue)

Offre gratuite avec 300 emails/jour.

  1. Créez un compte sur brevo.com
  2. Allez dans Paramètres > SMTP & API
  3. Générez une clé SMTP
SMTP_HOST=smtp-relay.brevo.com
SMTP_PORT=587
SMTP_USER=votre-email@exemple.com
SMTP_PASSWORD=xkeysib-votre-clé-smtp
SMTP_SECURE=false

Mailpit (développement local)

Mailpit capture les emails localement pour le développement.

# Installation
brew install mailpit  # macOS
# ou
docker run -d -p 1025:1025 -p 8025:8025 axllent/mailpit

# Démarrage
mailpit
SMTP_HOST=localhost
SMTP_PORT=1025
SMTP_SECURE=false

Interface web : http://localhost:8025

Gmail

Gmail nécessite un "Mot de passe d'application" si vous avez la 2FA activée.

SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
SMTP_USER=votre-email@gmail.com
SMTP_PASSWORD=votre-mot-de-passe-application
SMTP_SECURE=false

SendGrid

SMTP_HOST=smtp.sendgrid.net
SMTP_PORT=587
SMTP_USER=apikey
SMTP_PASSWORD=SG.votre-clé-api
SMTP_SECURE=false

Comportement sans SMTP

Si SMTP n'est pas configuré :

  • Réinitialisation de mot de passe : Le lien est affiché dans les logs serveur
  • Vérification d'email : Même si REQUIRE_EMAIL_VERIFICATION=true, le lien est affiché dans les logs serveur
  • Aucune erreur n'est générée, l'application reste fonctionnelle