You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

259 lines
7.9 KiB

<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>