<chapter id="config-setupassist">
<title>Easy Setup with the Setup Assistant</title>
<para>
The first time you try to use email, the mail setup assistant
will ask you for some basic information, so
<application>Evolution</application> can let you use email. If
you prefer more detailed configuration, or if you want to make
changes to an existing email setup, see <xref
linkend="config-prefs">.
</para>
<sect1 id="config-setupassist-mail">
<title>Mail Setup</title>
<para>
The first time you try to send or receive mail with
<application>Evolution</application>, the <interface>mail
setup assistant</interface> will pop up to help you with your
email preferences. If you don't plan to use email, or if
you'd rather deal with your email preferences later, click
<guibutton>Cancel</guibutton>.
</para>
<para>
The setup assistant (sometimes called a
<glossterm>Druid</glossterm>) will guide you through the
network configuration process. It will ask you for some
basic information; your system administrator or ISP should
have the answers you'll need. The mail setup assistant is
pictured in <xref linkend="usage-setup-fig">.
<!-- ==============Figure=================================== -->
<!-- druid-pic should eventually become assistant-pic -->
<figure id="usage-setup-fig">
<title>Mail Setup Assistant</title>
<screenshot>
<screeninfo>Evolution Main Window</screeninfo>
<graphic fileref="fig/mail-druid-pic" format="png" srccredit="Kevin Breit">
</graphic>
</screenshot>
</figure>
<!-- ==============End of Figure=================================== -->
The assistant will ask you for the following information:
<variablelist>
<varlistentry>
<term> <guilabel>Name:</guilabel> </term>
<listitem> <para>Your
full name: eg. Eva Lucianne Tester </para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Email address:</guilabel></term>
<listitem><para>
Your email address: eg. eltester@helixcode.com
</para></listitem>
</varlistentry>
<varlistentry>
<term> <guilabel>Organization:</guilabel></term>
<listitem>
<para>
Any organization you represent; often, the company where
you work. Leave this blank if you wish. One person I
know always puts "My own bad self" in this box, so
people know his opinions are his alone.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Signature File:</guilabel></term>
<listitem>
<para>
A text file appended to any email you send. A signature
file typically consists of your name and email address,
or a quotation you like. It should be fewer than four
lines of text.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term> <guilabel>Mail source type:</guilabel></term>
<listitem>
<para>
<application>Evolution</application> supports three mail
sources: <glossterm>POP</glossterm> servers,
<glossterm>IMAP</glossterm> servers, and UNIX-style
<filename>mbox</filename> files. POP servers retrieve
your mail and store it on your local system so you can
refer to it even when not connected to a network;
<glossterm>IMAP</glossterm> servers store the mail on
the server so you can access it from multiple locations;
UNIX-style <filename>mbox</filename> files are used by
your computer for internal mail, and may be useful if
you want to switch from another email client such as
<application>spruce</application> or
<application>mutt</application>. Ask your system
administrator which you should use, or keep guessing
until one works. You may use multiple servers if you
wish; see <xref linkend="config-prefs-mail-network"> for
more information.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term> <guilabel>Server:</guilabel></term>
<listitem>
<para>
This should be the name of your mail server: it should
look something like:
<userinput>mailserver.organization.org</userinput>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Username:</guilabel></term>
<listitem>
<para>
Normally, this is the part of your email address before
the @ character, and
<application>Evolution</application> has selected that
value as the default. If you have a different username,
you can enter it here.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Authentication:</guilabel></term>
<listitem>
<para>
Select the type of authentication you will use. You can
click <guibutton>Detect supported types</guibutton> to
find out which authentication protocols your network
allows.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Mail Transport:</guilabel></term>
<listitem>
<para>
This is the mail sending protocol you will want to use.
<application>Evolution</application> supports both SMTP
and <application>sendmail</application>.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>
To learn how to configure <application>Evolution</application>
in greater detail, or to change preferences once you have set
them, see <xref linkend="config-prefs">.
</para>
</sect1>
</chapter>
