Merge pull request #200 from dbarzin/dev

Documentation
dbarzin · Oct 19, 2024 · 17f18c0 · 17f18c0
2 parents a8a0821 + 3b26975
commit 17f18c0
Show file tree

Hide file tree

Showing 3 changed files with 33 additions and 35 deletions.
diff --git a/INSTALL.debian.fr.md b/INSTALL.debian.fr.md
@@ -186,23 +186,22 @@ Après avoir modifié le(s) fichier(s) php.ini, vous devez redémarrer le servic
 
 ## Configuration du mail
 
-Si vous souhaitez envoyer des mails de notification depuis Deming.
-
-Installer postfix et mailx
-
-    su root -c "apt install postfix mailutils"
-
-Configurer postfix
-
-    su root -c "dpkg-reconfigure postfix"
-
-Puis relancer postfix
-
-    su - root -c "systemctl reload postfix"
-
-Envoyer un mail de test avec
-
-    echo "Test mail body" | mailx -r "deming@yourdomain.local" -s "Subject Test" yourname@yourdomain.local
+Si vous souhaitez envoyer des e-mails de notification depuis Deming.
+Vous devez configurer l'accès au serveur SMTP dans .env
+
+    MAIL_HOST='smtp.localhost'
+    MAIL_PORT=2525
+    MAIL_AUTH=true
+    MAIL_SMTP_SECURE='ssl'
+    MAIL_USERNAME=
+    MAIL_PASSWORD=
+
+Vous pouvez également configurer DKIM :
+
+    MAIL_DKIM_DOMAIN = 'admin.local';
+    MAIL_DKIM_PRIVATE = '/path/to/private/key';
+    MAIL_DKIM_SELECTOR = 'default'; // Match your DKIM DNS selector
+    MAIL_DKIM_PASSPHRASE = '';      // Only if your key has a passphrase
 
 N'oubliez pas de [configurer](https://dbarzin.github.io/deming/config.fr/#notifications) le contenu et la fréquence d'envoi des mails.
 

diff --git a/INSTALL.debian.md b/INSTALL.debian.md
@@ -199,23 +199,22 @@ After modifying the php.ini file(s), you must restart the Apache service to use
 
 ## Mail configuration
 
-If you want to send notification e-mails from Deming.
-
-Install postfix and mailx
-
-    su root -c "apt install postfix mailutils"
-
-Configure postfix
-
-    su root -c "dpkg-reconfigure postfix"
-
-Then restart postfix
-
-    su - root -c "systemctl reload postfix"
-
-Send a test mail with
-
-    echo "Test mail body" | mailx -r "deming@yourdomain.local" -s "Subject Test" yourname@yourdomain.local
+If you wish to send notification e-mails from Deming.
+You have to configure the SMTP server access in .env
+
+    MAIL_HOST='smtp.localhost'
+    MAIL_PORT=2525
+    MAIL_AUTH=true
+    MAIL_SMTP_SECURE='ssl'
+    MAIL_USERNAME=
+    MAIL_PASSWORD=
+
+You may also configure DKIM :
+
+    MAIL_DKIM_DOMAIN = 'admin.local';
+    MAIL_DKIM_PRIVATE = '/path/to/private/key';
+    MAIL_DKIM_SELECTOR = 'default'; // Match your DKIM DNS selector
+    MAIL_DKIM_PASSPHRASE = '';      // Only if your key has a passphrase
 
 Don't forget to [configure](https://dbarzin.github.io/deming/config.fr/#notifications) the content and frequency of mail sending.
 

diff --git a/resources/views/layout.blade.php b/resources/views/layout.blade.php
@@ -160,7 +160,7 @@
             </ul>
         <div class="w-100 text-center text-small data-box p-2 border-top bd-grayMouse" style="position: absolute; bottom: 0">
             <div>Github <a href="https://github.com/dbarzin/deming" class="no-decor">dbarzin/deming</a></div>
-            <div>Version 2024-10-R3</div>
+            <div>Version 2024-10-R4</div>
         </div>
     </div>