Differences

This shows you the differences between two versions of the page.

--- pop3_imap_and_smtp_auth_for_popular_mail_clients [2021/03/22 20:09] – hc9
+++ pop3_imap_and_smtp_auth_for_popular_mail_clients [2024/04/04 08:04] (current) – acs hc9
@@ Line 5: / Line 5: @@
 SDF uses SMTP Authentication to allow remote network clients such as desktop, tablet and phone mail applications to use its SMTP server for the purpose of sending (relaying) e-mail messages. SDF users with the VPM, VHOST and MetaARPA memberships have access to the SMTP server.
-=== Quick Starter Notes ===
+==== Quick Starter Notes ====
 === Receiving Email ===
@@ Line 22: / Line 22: @@
 Please note: the SMTP AUTH secret is set on the command line via mkvpm. The command history of the shell may keep the secret in the history file.
-===== The Mail Client Configurations =====
+==== The Mail Client Configurations ====
 Please note that BlueMail on Android does not support the correct password encryption algorithm, and therefore you cannot set up your SDF email account under BlueMail. The devs have been notified of this bug; if they do fix it, the instructions here will be updated.
+===== Emacs (SMTPmail, Rmail, Gnus) =====
+The GNU Emacs editor includes several subsystems for handling email, including:
+  * **SMTPmail** for sending email,
+  * **Rmail** for reading email,
+  * **Gnus**, a news reader that can also be used for reading email.
+(Normally, you would choose to read email in Emacs with //either// Rmail or Gnus and would only configure the email reader of your choice.)
+Configuration for these subsystems varies depending on whether you are running Emacs **locally** on the SDF system that hosts your email spool or **remotely** on another system like your home PC.
+In either case, configuration mainly takes the form of Emacs Lisp expressions added to the startup file (usually ‘~/.emacs’) on the system where you will run Emacs. Optionally, the file ‘~/.gnus’ can be used for Gnus configuration to reduce clutter in your main startup file.
+=== Common Configuration ===
+Set the following variables regardless of which email subsystems you will you and whether you will be accessing email locally or remotely.
+<file config>
+(setq
+   user-full-name "<your full name>"
+   user-mail-address "<your email address>")
+</file>
+===  Local Configuration ===
+**WARNING:** If you use either Rmail or Gnus to read email locally on your SDF email host system, all messages in your email spool at the time you start Rmail or Gnus will be //removed// from the spool and transferred to the email reader's inbox. Make a backup of your email spool (‘/sdf/mail/<username>’) beforehand unless you are committed to handling your email with Rmail or Gnus.
+<file config>
+;; For SMTPmail ...
+(setq send-mail-function 'sendmail-send-it)
+;; For Rmail, no configuration is necessary for local access.
+;; For Gnus ...
+(setq gnus-secondary-select-methods '((nnml "")))
+</file>
+=== Remote Configuration ===
+<file config>
+;; For SMTPmail ...
+(setq
+   send-mail-function 'smtpmail-send-it
+   smtpmail-default-smtp-server "mx.sdf.org"
+   smtpmail-local-domain "sdf.org"
+   smtpmail-smtp-service 587
+   smtpmail-stream-type 'starttls)
+(load-library "smtpmail")
+;; For Rmail ...
+(setq
+   rmail-primary-inbox-list '("imaps://<username>:<password>@mx.sdf.org")
+   rmail-preserve-inbox t)     ; (If you want to keep your mail in your SDF IMAP inbox.)
+;; For Gnus ...
+(add-to-list 'gnus-secondary-select-methods
+  '(nnimap "mx.sdf.org"
+    (nnimap-address "mx.sdf.org")
+    (nnimap-server-port 143)
+    (nnimap-stream starttls)))
+</file>
+Additionally, for remote access place the following lines in the file ‘~/.authinfo’ (or ‘~/.authinfo.gpg’ for encryption):
+<file config>
+machine mx.sdf.org port 587 login <mkvpm domain>@sdf.org password <mkvpm secret>
+machine mx.sdf.org port 143 login <username> password <password>
+</file>
+==== Email Commands ====
+After you have completed the configuration, start or restart Emacs and use the following commands to access your email:
+^ description ^ //command// ^
+| SMTPmail: | ''C-x m'' |
+| Rmail: | ''M-x rmail'' |
+| Gnus: | ''M-x gnus'' |
 ===== K-9 Mail for Android =====
@@ Line 123: / Line 207: @@
 </code>
-  Account-specific smtp settings are possible; see the Heirloom Mailx documentation.
+Account-specific smtp settings are possible; see the Heirloom Mailx documentation.
 ===== Postfix MTA using libsaslc(3) on NetBSD 6.x: =====
@@ Line 158: / Line 242: @@
 </code>
-   ///etc/postfix/generic//
+///etc/postfix/generic//
 <code>
@@ Line 196: / Line 280: @@
 </code>
-  You should now be set up to use SDF's SMTP server. Enjoy!
+You should now be set up to use SDF's SMTP server. Enjoy!
 ===== iPhone Mail Application =====