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:07] – [Quick Starter Notes] 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 26: / Line 26: @@
 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.
-==== K-9 Mail for Android ====
+===== 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 =====
 ^ To //retrieve// mail via IMAP ^^
@@ Line 45: / Line 129: @@
   * If you are a Meta-ARPA member and //not// a VHOST member, this is whatever web domain you've chosen (frequently username.sdf.org@sdf.org). If you're a VHOST member, it's your VHOST domain.
-==== Outlook Express under Windows ====
+===== Outlook Express under Windows =====
   * Open Outlook Express
@@ Line 66: / Line 150: @@
   * Click 'Apply'
-==== Mail.App under Macos X ====
+===== Mail.App under Macos X =====
   * Open Mail.app
@@ Line 80: / Line 164: @@
   * Click ok, and close the Preferences window.
-==== Mozilla Thunderbird ====
+===== Mozilla Thunderbird =====
   * Tools -> Account Settings -> Add Mail Account
@@ Line 101: / Line 185: @@
   * You will be prompted for your SMTP password the first time you go to send mail. This is the password generated by mkvpm on the command line.
-==== Heirloom Mailx under Linux/BSD ====
+===== Heirloom Mailx under Linux/BSD =====
 Add the following to ~homeuser/.nailrc to set the default SMTP relay:
@@ 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: ====
+===== Postfix MTA using libsaslc(3) on NetBSD 6.x: =====
   * first, verify that //postfix(1)// knows about //libsaslc// :
@@ 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 =====