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.
344 lines
16 KiB
344 lines
16 KiB
<chapter id="getting-started"> |
|
|
|
<chapterinfo> |
|
<authorgroup> |
|
<author> |
|
<firstname>Daniel</firstname> |
|
<surname>Naber</surname> |
|
<affiliation><address> |
|
<email>daniel.naber@t-online.de</email> |
|
</address></affiliation> |
|
</author> |
|
<author> |
|
<firstname>David</firstname> |
|
<surname>Rugge</surname> |
|
<affiliation><address> |
|
<email>davidrugge@mediaone.net</email> |
|
</address></affiliation> |
|
</author> |
|
<author> |
|
<firstname>Michel</firstname> |
|
<surname>Boyer de la Giroday</surname> |
|
<affiliation><address> |
|
<email>michel@klaralvdalens-datakonsult.se</email> |
|
</address></affiliation> |
|
</author> |
|
<author> |
|
<firstname>Scarlett</firstname> |
|
<surname>Clark</surname> |
|
<affiliation><address> |
|
&Scarlett.Clark.mail; |
|
</address></affiliation> |
|
</author> |
|
|
|
<!-- TRANS:ROLES_OF_TRANSLATORS --> |
|
</authorgroup> |
|
<date>2017-04-18</date> |
|
<releaseinfo>Applications 17.08</releaseinfo> |
|
</chapterinfo> |
|
|
|
|
|
<title>Getting Started</title> |
|
|
|
<para>This is a short introduction to &kmail; and its usage so you can |
|
start working with it right away. For more in-depth information see the |
|
<link linkend="using-kmail">Using &kmail;</link> section.</para> |
|
|
|
<sect1 id="account-wizard"> |
|
<title>Account Wizard</title> |
|
|
|
<screenshot> |
|
<screeninfo>Account Wizard</screeninfo> |
|
<mediaobject> |
|
<imageobject> |
|
<imagedata fileref="accountwizard.png" format="PNG"/> |
|
</imageobject> |
|
<textobject> |
|
<phrase>Account Wizard</phrase> |
|
</textobject> |
|
<caption> |
|
<para>Account Wizard</para> |
|
</caption> |
|
</mediaobject> |
|
</screenshot> |
|
|
|
<para>The first time you run &kmail; you will be greeted with the Account Wizard.</para> |
|
<note><para>If at anytime you need to run the account wizard again, you can find it under |
|
<menuchoice><guimenu>Settings</guimenu><guimenuitem>Add Account</guimenuitem></menuchoice>.</para></note> |
|
<para>The wizard will take you through the process of creating your email accounts. Your screens will vary depending |
|
on how much the wizard can determine on its own. Below is an outline of the screens you may encounter while using this wizard.</para> |
|
<itemizedlist> |
|
<listitem> |
|
<para><guilabel>Provide personal data</guilabel> is the first screen of the wizard. It will prompt you for your basic account information: <guilabel>Full name:</guilabel>, <guilabel>E-mail address</guilabel>, and <guilabel>Password</guilabel>. |
|
By default, the <guilabel>Find provider settings on the Internet</guilabel> option is checked, the wizard will attempt to retrieve the necessary |
|
information from the server. Uncheck this option if you are an expert user and you need to set up advanced configuration. Click the <guibutton>Next</guibutton> button once finished. |
|
<note><para>If you use GMail 2-step verification you will need to generate an application-specific password within gmail security settings and enter that password |
|
in the password text box.</para></note><!--FIXME verify this--> |
|
</para> |
|
</listitem> |
|
<listitem> |
|
<para>If you want to secure your communication with GnuPG you can generate a new key and publish the key on a public key server |
|
or import an existing key. |
|
</para> |
|
<para>When sending mails &kmail; then automatically looks for encryption keys of your recipients and secures the mail when keys for each recipient can be found. |
|
It also signs your mails cryptographically so that it can be verified that your messages have not been tampered with. |
|
</para> |
|
</listitem> |
|
<listitem> |
|
<para>The <guilabel>Select Account Type</guilabel> screen will be next if the wizard cannot determine your account type. Select your account type from the |
|
list (if you do not know, you will need to contact your email provider). If your account type is not listed, click the <guibutton>Check for more on Internet</guibutton> button. |
|
Once your account type has been selected, click the <guibutton>Next</guibutton> button, and you will be presented with the <guilabel>Personal Settings</guilabel> screen. |
|
</para> |
|
<para>The <guilabel>Provide personal data</guilabel> screen will show again with the server details it found if the wizard was successful at determining the account type. |
|
Click the <guibutton>Finish</guibutton> set up the account, complete the wizard and close the window. |
|
</para> |
|
<!--FIXME Maildir + MailBox URL: but no input field on the next screen?--> |
|
</listitem> |
|
<listitem> |
|
<para>The <guilabel>Personal Settings</guilabel> screen will show if you had to enter your account type. |
|
Verify that your information is correct on this page. Select <guilabel>Download all messages for offline use</guilabel> |
|
if you want your messages available when you do not have an Internet connection (&imap; only). |
|
Click the <guibutton>Next</guibutton> button once finished.</para> |
|
</listitem> |
|
<listitem> |
|
<para>Your account will then be set up, and you can click the <guibutton>Finish</guibutton> button to complete the wizard and close the window.</para> |
|
</listitem> |
|
</itemizedlist> |
|
<para>For manually creating accounts please continue reading the rest of this document.</para> |
|
|
|
</sect1> |
|
|
|
<sect1 id="manual-configuration-quickstart"> |
|
<title>Manual Configuration Quickstart</title> |
|
<para>The Configure window consists of six sections: |
|
<guilabel>Identities</guilabel>, <guilabel>Accounts</guilabel>, |
|
<guilabel>Appearance</guilabel>, <guilabel>Composer</guilabel>, |
|
<guilabel>Security</guilabel>, <guilabel>Misc</guilabel>, and |
|
<guilabel>Plugins</guilabel>.</para> |
|
|
|
<para>To begin sending and receiving messages you will only have to |
|
change some settings in the <guilabel>Identities</guilabel> and |
|
<guilabel>Accounts</guilabel> pages.</para> |
|
|
|
<sect2 id="setting-your-identity"> |
|
<title> |
|
Setting your Identity |
|
</title> |
|
|
|
<para> |
|
The settings in the <guilabel>Identities</guilabel> page are |
|
fairly straightforward. Select your default identity and click |
|
<guibutton>Modify</guibutton>. Fill in the <guilabel>Your |
|
name</guilabel> field with your full name (⪚ <userinput>John |
|
Doe</userinput>) and the <guilabel>Organization</guilabel> field |
|
(optional) with the appropriate information. |
|
</para> |
|
<para> |
|
Next, fill in the <guilabel>Email address</guilabel> field with |
|
your email address (⪚ <userinput>john@example.net</userinput>). |
|
</para> |
|
<para> |
|
If you are using <application>PGP</application> or |
|
<application>GnuPG</application> you can set your &openpgp; keys |
|
and/or &smime; certificates in the <link |
|
linkend="configure-identity-cryptography"><guilabel>Cryptography</guilabel></link> |
|
tab. |
|
</para> |
|
<!--FIXME Advanced Templates Picture tabs--> |
|
<para> |
|
Optionally, go to the <guilabel>Signature</guilabel> tab and |
|
enter your signature. This is a short text that will be |
|
automatically appended to all your messages. It has nothing to |
|
do with <emphasis>digital signatures</emphasis>. |
|
</para> |
|
|
|
</sect2> |
|
|
|
<sect2 id="setting-up-your-account"> |
|
<title>Setting up your Account</title> |
|
|
|
<para>The <guilabel>Accounts</guilabel> page contains the settings that |
|
tell &kmail; how to send and receive your email messages. Many of these settings |
|
can vary greatly depending on the setup of your system and on the kind |
|
of network that your mail server is located in. If you do not know what |
|
setting to choose or what to put in a field, consult your Internet |
|
Service Provider (<acronym>ISP</acronym>) or system |
|
administrator.</para> |
|
|
|
<sect3 id="sending-mail"> |
|
<title>Sending Messages</title> |
|
|
|
<para>The <guilabel>Sending</guilabel> tab provides a list of |
|
ways to send messages. The first item in the list is the default |
|
way to send messages. Using the <guibutton>Add...</guibutton> |
|
button you can fill in the <guilabel>Name</guilabel> |
|
field with a descriptive name |
|
(⪚ <userinput>My Mail Account</userinput>). Click the <guibutton>Create and Configure</guibutton> |
|
and fill the <guilabel>Outgoing mail server</guilabel> |
|
field with the name and domain of your mail server |
|
(⪚ <userinput>smtp.provider.com</userinput>). You will probably |
|
not need to change the <guilabel>Port</guilabel> setting (the default is |
|
<userinput>25</userinput>).</para> |
|
|
|
<para>The way of sending messages configured here will be used for |
|
your default identity and for all other identities that do not have their own |
|
way of sending messages. You can use different ways of sending |
|
messages for different identities by selecting the <guilabel>Outgoing |
|
Account</guilabel> check box in the <guilabel>Advanced</guilabel> |
|
tab of the <guilabel>Identities</guilabel> page.</para> |
|
|
|
<para>A description of the other options can be found |
|
in the <link linkend="configure-accounts-sending">Configuration</link> |
|
chapter.</para> |
|
</sect3> |
|
|
|
<sect3 id="sending-mail-kolab"> |
|
<title>Options relevant to <acronym>Kolab</acronym> server</title> |
|
|
|
<para>When configuring an <guilabel>SMTP</guilabel> account with a <guilabel>Kolab</guilabel> server Host, you need to check the <guilabel>Server requires authentication</guilabel> option and to fill in your <guilabel>Kolab</guilabel> user's email address and password in the <guilabel>Login</guilabel> and <guilabel>Password</guilabel> fields. Then select the <guilabel>Security</guilabel> tab and click on the <guibutton>Check What the Server Supports</guibutton> for automated setup of your <guilabel>Security</guilabel> configuration. The default should be <guilabel>TLS/PLAIN</guilabel>. The <guilabel>Kolab</guilabel> server supports <guilabel>SSL/PLAIN</guilabel> as well. These settings may of course be configured manually.</para> |
|
</sect3> |
|
</sect2> |
|
|
|
<sect2 id="receiving-mail"> |
|
<title>Receiving Messages</title> |
|
|
|
<para>By default the <guilabel>Local Folders</guilabel> (inbox, outgoing, sentmail, |
|
trash, drafts and templates) with data from a local Maildir folder are predefined on this tab. |
|
Using the drop down box you can select the <guilabel>Retrieval Options</guilabel> for these folders.</para> |
|
|
|
<para>To set up an account so you can receive mail, press the |
|
<guibutton>Add...</guibutton> button in the <guilabel>Receiving</guilabel> |
|
tab. You will then be prompted for the type of your email account. Most users should |
|
select <guilabel>POP3 E-Mail Server</guilabel> or <guilabel>IMAP E-Mail Server</guilabel>. If |
|
you want to use a local mailbox file, please see the <link linkend="faq-file-locking">FAQ |
|
about file locking</link>.</para> |
|
|
|
<para>You will then be presented with |
|
the account settings window. First, fill in the |
|
<guilabel>Account name</guilabel> field to name your account. You can choose any name |
|
you like. <guilabel>Username</guilabel>, <guilabel>Password</guilabel>, and |
|
<guilabel>Incoming mail server</guilabel> should be filled in with the appropriate information |
|
from your <acronym>ISP</acronym> or system administrator. You should not |
|
need to change the <guilabel>Port</guilabel> setting (the default for POP3 is |
|
<userinput>110</userinput>, the default for <acronym>IMAP</acronym> is |
|
<userinput>143</userinput>).</para> |
|
|
|
<sect3 id="receiving-mail-imap"> |
|
<title>Options only relevant to <acronym>IMAP</acronym></title> |
|
|
|
<para>If you check <guilabel>Automatically compact folders</guilabel> |
|
&kmail; removes the messages you deleted from the |
|
server as soon as you leave a folder. Otherwise the messages are |
|
only marked as deleted and it is up to you to compact the folders |
|
manually by using the menu item <menuchoice><guimenu>File</guimenu><guimenuitem>Compact All |
|
Folders</guimenuitem></menuchoice>.</para> |
|
<para>If you check <guilabel>Show hidden folders</guilabel>, |
|
folders whose name starts with a dot are also displayed.</para> |
|
</sect3> |
|
|
|
|
|
<sect3 id="receiving-mail-pop3"> |
|
<title>Options only relevant to POP3</title> |
|
|
|
<para>Select <guilabel>Leave fetched messages on the server</guilabel> if you want to |
|
leave your messages on the server after you downloaded them.</para> |
|
|
|
<para>Select <guilabel>Include in Manual Mail Check</guilabel> if you |
|
want to check this account whenever you use <menuchoice><guimenu>File</guimenu><guimenuitem>Check |
|
Mail</guimenuitem></menuchoice>. If you unselect this option you can still check for new messages on this account |
|
with <menuchoice><guimenu>File</guimenu><guimenuitem>Check Mail |
|
In</guimenuitem></menuchoice>.</para> |
|
|
|
<para>Select <guilabel>Enable interval mail checking</guilabel> if you want |
|
&kmail; to check for new messages automatically. The interval can be specified below |
|
under <guilabel>Check mail interval</guilabel>.</para> |
|
|
|
<para><guilabel>inbox</guilabel> is the default folder for incoming |
|
messages. If you want to change that for some reason, you can do so with |
|
<guilabel>Destination folder</guilabel>. But what you probably want is a |
|
<link linkend="filters">filter</link>, which has nothing to do with this |
|
option.</para> |
|
|
|
<para>With <guilabel>Pre-command</guilabel> you can specify any program that &kmail; |
|
will execute just before fetching mail. Please specify the full path |
|
(do not use <quote>~</quote>) and note that &kmail; will not continue |
|
until the program returns.</para> |
|
|
|
<para>In the <guilabel>POP Settings</guilabel> group you can select <guilabel>Use |
|
pipelining for faster mail download</guilabel> if this is supported by your |
|
server. You should carefully test this to make sure it works safely.</para> |
|
</sect3> |
|
|
|
<sect3 id="receiving-mail-imap-pop3"> |
|
<title>Options for both <acronym>IMAP</acronym> and POP3</title> |
|
<para>&kmail; supports encryption via <guilabel>SSL/TLS</guilabel> and |
|
<guilabel>STARTTLS</guilabel> (<guilabel>SSL/TLS</guilabel> should be preferred |
|
if it is available).</para> |
|
|
|
<para>For POP3 &kmail; supports:</para> |
|
|
|
<itemizedlist> |
|
<listitem><para><guilabel>Clear text</guilabel>, </para></listitem> |
|
<listitem><para><guilabel>PLAIN</guilabel>, </para></listitem> |
|
<listitem><para><guilabel>LOGIN</guilabel>, </para></listitem> |
|
<listitem><para><guilabel>CRAM-MD5</guilabel> (recommended |
|
if <guilabel>DIGEST-MD5</guilabel> is not available),</para></listitem> |
|
<listitem><para><guilabel>DIGEST-MD5</guilabel> (recommended),</para></listitem> |
|
<listitem><para><guilabel>NTLM</guilabel>,</para></listitem> |
|
<listitem><para><guilabel>GSSAPINTLM</guilabel> and </para></listitem> |
|
<listitem><para><guilabel>APOP</guilabel> authentication.</para></listitem> |
|
</itemizedlist> |
|
|
|
<para><guilabel>DIGEST-MD5</guilabel>, <guilabel>CRAM-MD5</guilabel> and |
|
<guilabel>APOP</guilabel> are secure on their own, the other |
|
options are only secure when used together with <guilabel>SSL</guilabel> |
|
or <guilabel>TLS</guilabel>. You should only use <guilabel>Clear |
|
text</guilabel> if your server does not support any of the other |
|
authentication methods. Additionally, for <acronym>IMAP</acronym> |
|
<guilabel>Anonymous</guilabel> is supported, but <guilabel>APOP</guilabel> |
|
is not. Use the <guibutton>Check what the server supports</guibutton> button |
|
on the <guilabel>Security</guilabel> tab |
|
to automatically select the most secure settings supported by your server.</para> |
|
|
|
<para>You are now ready to send and receive mail. For |
|
<acronym>IMAP</acronym>, just open your folders in the |
|
folder tree in &kmail;'s main window. &kmail; then connects to your |
|
server and displays the messages it finds. For POP3 use |
|
<menuchoice><guimenu>File</guimenu><guimenuitem>Check |
|
Mail</guimenuitem></menuchoice>.</para> |
|
|
|
</sect3> |
|
|
|
</sect2> |
|
|
|
</sect1> |
|
|
|
<sect1 id="testing-your-setup"> |
|
<title>Testing your Setup</title> |
|
|
|
<para>First, you should send yourself a message to test your |
|
configuration. To send a message, either hit <keycombo |
|
action="simul">&Ctrl;<keycap>N</keycap></keycombo>, select the |
|
<guiicon>New Message</guiicon> icon or select |
|
the <menuchoice><guimenu>Message</guimenu><guimenuitem>New |
|
Message...</guimenuitem></menuchoice> menu item. The |
|
<link linkend="the-composer-window">composer window</link> will appear. Fill in the |
|
<guilabel>To:</guilabel> field with your email address and type |
|
something in the <guilabel>Subject</guilabel> field. Send the message by |
|
selecting <menuchoice><guimenu>Message</guimenu> <guimenuitem>Send Mail</guimenuitem> |
|
</menuchoice>.</para> |
|
|
|
<para>To check your email, select |
|
<menuchoice><guimenu>File</guimenu><guimenuitem>Check |
|
Mail</guimenuitem></menuchoice>. In the lower right corner of the main |
|
window, a progress bar will indicate how many messages are being |
|
downloaded. If you receive the message you just sent, then |
|
congratulations! If, however, you receive any error messages while |
|
testing your setup, make sure that your network connection is working |
|
and recheck your settings at |
|
<menuchoice><guimenu>Settings</guimenu> <guimenuitem>Configure |
|
&kmail;...</guimenuitem></menuchoice>.</para> |
|
|
|
</sect1> |
|
|
|
</chapter>
|
|
|