Différences

Ci-dessous, les différences entre deux révisions de la page.

--- devweb:maildev [25-11-2023 22:31] – edmc73
+++ devweb:maildev [26-09-2025 14:30] (Version actuelle) – edmc73
@@ Ligne 1: / Ligne 1: @@
 ====== MailDev ======
-Installation
+===== Documentation =====
+https://github.com/maildev/maildev
+  * Ouverture d'un service SMTP sur le port 1025
+  * Ouverture d'un service Web sur le port 1080
+===== Installation via npm =====
   npm install -g maildev # Utilisez sudo si nécessaire
@@ Ligne 7: / Ligne 14: @@
-Via un docker
+===== Via docker =====
-La version simple consiste rediriger les ports sur votre machine
+Commande docker de base
   docker run -d --name maildev -p 1080:1080 -p 1025:1025 maildev/maildev
-Dans un cas plus complexe, sur une VM distante :
+Commande avec persistance des données et protection par mot de passe
-  * --restart always : permet au container de toujours redémarrer en cas de crash ou au reboot de l'hote
+  docker run -d --name maildev -p 1080:1080 -p 1025:1025 -u root -v mail_data:/tmp/mail_data --restart always maildev/maildev bin/maildev --web-user toto --web-pass motdepasse --mail-directory /tmp/mail_data
+Explication :
+  * ''--restart always'' : permet au container de toujours redémarrer en cas de crash ou au reboot de l'hote
   * On peut passer des paramètres à la commande maildev, pour ça il faut le spécifier après le nom de l'image
-    * bin/maildev --toutes mes options
+    * ''bin/maildev --toutes mes options''
   * Si vous voulez protéger par un mot de passe l'accès à votre maildev
-    * --web-user
+    * ''--web-user''
-    * --web-pass
+    * ''--web-pass''
   * Pour la persistance des données
-    * --mail-directory /tmp/mail_data  : on peut mettre ce que l'on veut au final
+    * ''--mail-directory /tmp/mail_data''  : on peut mettre ce que l'on veut au final
-    * -v mail_data:/tmp/mail_data   : crée un volume dans /var/lib/docker/volumes/mail_data et le monte sur le dossier /tmp/mail_data du container
+    * ''-v mail_data:/tmp/mail_data''   : crée un volume dans ''/var/lib/docker/volumes/mail_data'' et le monte sur le dossier ''/tmp/mail_data du container''
-    * -u root   : malheureusement, l'utilisateur node lancé par défaut, n'a pas les droits d'écriture sur le montage, on force alors l'éxécution de maildev avec l'utilisateur root
+    * ''-u root''   : malheureusement, l'utilisateur **node** lancé par défaut, n'a pas les droits d'écriture sur le montage du volume, on force alors l'exécution de maildev avec l'utilisateur root
+===== Via docker compose =====
+Créer un répertoire maildev et créer un fichier docker-compose.yml à l'intérieur
+<code yaml - docker-compose.yml>
+services:
+  maildev:
+    image: maildev/maildev
+    container_name: maildev
+    ports:
+      - "1080:1080" # Interface web
+      - "1025:1025" # Serveur SMTP
+    volumes:
+      - mail_data:/tmp/mail_data
+    user: "0" # Équivalent de -u root, nécessaire pour des problèmes de droit sur le volume mail_data
+    environment:
+      - TZ=Europe/Paris
+      # Définit le répertoire où les emails seront persistés (liés au volume)
+      - MAILDEV_MAIL_DIRECTORY=/tmp/mail_data
+      # Pour sécuriser l'accès pas un mot de passe
+      # - MAILDEV_WEB_USER=admin
+      # - MAILDEV_WEB_PASS=password
+    restart: always
+volumes:
+  mail_data:
+</code>
+Puis lancer la commande
+  docker compose up -d
+Pour mettre à jour
+  docker compose pull
+  docker compose up -d
+===== FIX CSS =====
+J'ai croisé un petit problème de CSS, pour le corriger
+  docker exec -it maildev sh
+  vi /home/node/app/styles/style.css
+Rechercher le terme "email-content" et corriger le "height"
+  .email-content{box-sizing:border-box;z-index:1;height:calc(100vh - 8.5em)}
-  docker run -d --name maildev -p 1080:1080 -p 1025:1025 -u root -v mail_data:/tmp/mail_data --restart always maildev/maildev bin/maildev --web-user toto --web-pass 12345 --mail-directory /tmp/mail_data

Outils pour utilisateurs

Outils du site

Différences

Outils de la page