tutes-dump/site-tutorials/e-mail-basics.html

<h1>E-Mail, Basics</h1>
<p>This tutorial covers the basics of accessing E-mail on SDF.
Topics include command-line and remote access.  Configuration
of mail retrieval programs (<tt>fetchmail</tt>, <tt>getmail</tt>) and Mail User Agents
(such as Mozilla Thunderbird) will also be covered.</p>

<h3>Contents</h3>
<ol>
 <li><a href="#intro">Introduction, and what this is <em>not</em></a></li>
 <li><a href="#reading">Reading E-mail on SDF</a></li>
 <!-- <li><a href="#viewlinks">Following links in an e-mail on your local machine</a></li> -->
 <li><a href="#fetch">Fetching E-Mail with <tt>fetchmail</tt> or <tt>getmail</tt></a></li>
 <li><a href="#webmail">Accessing SDF E-mail via Webmail</a></li>
 <li><a href="#guimua">Configuring Graphical Mail User Agents</a></li>
 <li><a href="#ios">Configuring Mail in iOS (as a MetaARPA member)</a></li>
<!--
 <li><a href="#gloss">Glossary</a> - explications of terms</li>
-->
</ol>
<hr />

<h2><a id="intro" />Introduction, and what you <em>will not</em> find here</h2>
<p> For basic info about e-mail (addresses, reader programs, file size, etc),
please read the corresponding
<a href="http://sdf.lonestar.org/index.cgi?faq?EMAIL">FAQ</a> entry.
Continue reading for more information about using E-mail services at SDF.
</p>

<p>
If you want to use a SDF's SMTP server to send mail, you must either log in
and use one of the clients as described in
<a href="http://sdf.org?tutorials/e-mail-beginners">the previous tutorial</a>,
or register at an appropriate
<a href="http://sdf.lonestar.org/index.cgi?faq?MEMBERS?01">membership level</a>
(VPM, VHOST, or MetaARPA) and
<a href="http://sdf.org?tutorials/smtpauth">connect using SMTP AUTH</a>.
</p>

<h2><a id="reading" />Reading E-Mail on SDF</h2>
<p>
Multiple mail clients are available to be used from the shell,
including <tt>pine</tt> and <tt>mutt</tt>.
</p>

<!-- <h2><a id="viewlinks" />Following links in an e-mail on your local machine</h2>
<p>
</p>
-->

<h2><a id="fetch" />Fetching E-Mail with <tt>fetchmail</tt>, <tt>getmail</tt> or <tt>offlineimap</h2>

<h3><a id="fetch-ex" />Sample <code>.fetchmailrc</code></h3>
<p>You can use <code>fetchmail</code> to retrieve messages from your SDF account.
The <tt>fetchmail</tt> example below is configured to use POP3 to retrieve E-mail.  Note
that this configuration does not use SSL.  Also note that you will need to provide your
user names and the path to procmail.  You may omit the <tt>pass</tt> line to be prompted
for your password.  <tt>fetchmail</tt> can be run in <em>daemon</em> mode to retrieve
mail at a desired interval: <tt>fetchmail -d 900</tt>.

</p>
<p>
<pre>
poll wm.sdf.org
     proto pop3
     user "sdf.username"
     pass "secret"
     is "local.username" here
     mda "/path/to/procmail -f- ~/.procmailrc";
</pre>
</p>


<h3><a id="fetch-ex2" />Sample <code>.getmail/sdf</code></h3>
<p> <tt>wm.sdf.org</tt> supports IMAPs in addition to POP3.
This configuration <em>will</em> use SSL.  A IMAP configuration (sans SSL) is commented out below.
Use <code>getmail</code> to collect messages.  Note that you will have to provide local
and remote user names and you will be prompted for your password.  Also note that this
configuration uses procmail as a delivery agent.
</p>
<p>
<pre>
[destination]
type=MDA_external
path=/usr/bin/procmail
arguments=("-dlocal.username",)

[options]
read_all=False
delete=False

[retriever]
type=SimpleIMAPSSLRetriever
#type=SimpleIMAPRetriever
server=wm.sdf.org
username=remote.username
#password=
port=993
#port=143
</pre>

You could alternatively configure, for instance, a Maildir destination if you
would prefer not to use <tt>procmail</tt>:
<pre>
[destination]
type = Maildir
path = ~/Maildir/
</pre>
</p>

<h3><a id="fetch-ex3" />Sample <code>.offlineimaprc</code></h3>
<p>Another option to retrive E-mail is <tt>offlineimap</tt>. The example below
uses it to retrive messages with IMAP, using SSL for encryption, and storing them in
Maildir format. The first option <tt>accounts</tt> contain a comma separated list
of accounts to sync, <tt>acc1</tt> and <tt>acc2</tt> are given as an example, they
are not needed if you are only syncing the sdf account. You may also need to adjust the
value of <tt>cert_fingerprint</tt> from time to time.

</p>

<p>
<pre>
accounts = acc1,acc2,sdf

[Account sdf]

localrepository = sdf-local
remoterepository = sdf-remote

[Repository sdf-local]

type = Maildir
localfolders = ~/Maildir
restoreatime = no

[Repository sdf-remote]

type = IMAP
ssl = yes
cert_fingerprint = 204b2c6188ce0d38fa1eb3e5db6e88af4e05f868
remotehost = mx.sdf.org
remoteport = 993
remoteuser = isf
</pre>
</p>


<h2><a id="webmail" />Accessing SDF E-mail via Webmail</h3>
<p>
General users visit <a href="https://wm.sdf.org">wm.sdf.org</a>, MetaARPA members visit <a href="https://ma.sdf.org">ma.sdf.org</a> if you've forwarded your mail to the MetaArray.
</p>

<h2><a id="guimua" />Configuring Graphical Mail User Agents</h2>

<h3>Mozilla Thunderbird Configuration</h3>
<p>
<em>Server Settings</em>
Server Type:	IMAP Mail Server <br />
Server Name:	mx.sdf.org <br />
Port:		993 <br />
User Name:	remote.username <br />
</p>
<p>
<em>Security Settings</em>
Connection security:	SSL/TLS <br />
Use secure authentication:	(unchecked) <br />
</p>

<h3>Apple Mail</h3>
<p>
Mail &#187; Preferences &#187; Accounts <br />
Click +
</p>

<p>
Enter your name and SDF E-mail address, then click <tt>Continue</tt>.
</p>

<p>
<em>Incoming Mail Server</em>
Account Type:	IMAP <br />
Description: 	SDF <br />
Incoming Mail Server:	mx.sdf.org <br />
User Name:	remote.username <br />
Password: 	remote.password <br />
Click <tt>Continue</tt>
</p>

<p>
Use your ISP's SMTP server for outgoing mail - unless you opt for
an SDF membership level that allows SMTP, in which case see the
<a href="http://sdf.org?tutorials/smtpauth">smtpauth tutorial</a>.
<br />
Click <tt>Continue</tt>
</p>

<p>
You should now see an account summary page.  Verify the summary and click <tt>Create</tt>.
<br />
You can now return to the Accounts preferences, select <tt>Advanced</tt>, and if necessary add:<br />
IMAP Path Prefix:	INBOX <br />
</p>

<h3>Outlook 365 for Windows 10</h3>

<p>
This one's not as obvious as you'd think. You'll need to close Outlook to begin with, and run this command. Click Start and then type:</p>

<p>
outlook.exe /manageprofiles
</p>

<p>
then click on <u>E</u>mail Accounts... &#187; New... &#187; Manual setup or additional server type &#187; Next &#187; POP or IMAP &#187; then fill in the form:
</p>

<p>
Your Name:             Filbert Exampleton<br />
Email Address:         efilbert@sdf.org<br />
Account Type:          IMAP<br />
Incoming mail server:  mx.sdf.org<br />
Outgoing mail server:  fill this in with a valid SMTP<br />
User Name:             efilbert<br />
Password:              ednaedison123<br />
</p>

<p>
then click More Settings... &#187; Outgoing Server &#187; My outgoing server (SMTP) requires authentication &#187; Log on using &#187; fill in the fields witn your smtp &#187; OK &#187; next
</p>

<p>
Outlook will perform a connection test, and after it passes, you can exit the wizard and configuration program. When you start Outlook back up, the SDF mail account should appear. What a friggin headache.
</p>


<h3><a id="ios" />Configuring Mail in iOS (as a MetaARPA member)</h3>
  <p>
    This can likely be done as an ARPA member, refer to system help or <code>bboard</code> for more information.

    <ul>
      <li>Open <b>Settings</b> and select <b>Mail, Contacts, and Calendars</b></li>
      <li>Select <b>Add Account</b>, then <b>Other</b></li>
      <li>Select <b>Add Mail Account</b> and fill in the relevant information.</li>
    </ul>
  </p>
  <p>
    Automatic setup will fail.  Once prompted, enter the following server information:

    <ul>
      <li>Incoming Mail Server</li>
      <ul>
        <li>Host Name: <code>wm.sdf.org</code></li>
        <li>User Name: <code>your sdf username</code></li>
        <li>Password: <code>your sdf password</code></li>
      </ul>
    </ul>
  </p>

<cite>$Id: e-mail-basics.html,v 1.19 2019/09/09 14:45:09 jawsh Exp $</cite>