View source for Working with GMail/en

<languages />
{{Warning|1=These instructions are only valid for kdepim and Korganizer version 4.3.7 and later. There are significant differences in the older versions, therefore, some instructions may not apply.}}

{{Note|1= For demonstration purposes, the Google account used in this tutorial is sync.with.kontact@gmail.com}}

== Introduction ==

This tutorial will allow you to setup ''IMAP'' forwarding from a Gmail account to '''KMail''', which can be accessible through '''Kontact'''.

== Incoming Mail Forwarding (IMAP Connection) ==

Firstly, you need to open '''Kontact'''.  You can access it by simply typing its name in the search bar. Now, after '''Kontact''' starts up, click on <menuchoice>Mail</menuchoice> in the left vertical navigation bar.
This brings you to the '''KMail''' part of '''Kontact'''. To set up the forwarding options, go to:
<menuchoice>Settings -> Configure KMail</menuchoice>.

The first step is to create a basic identify, this is to separate multiple accounts in the future, if you have them. 

{|class="tablecenter vertical-centered" 
|[[Image:Add_new_kmail_identity.png|250px|thumb]] 
|Setting up a new Kmail identity.
|[[Image:KontacT_integration_kmail_identity_settings_edit.png|250px|thumb]] 
|Configuring the new identity.
|}


Next, go to the <menuchoice>Accounts</menuchoice> tab on the left navigation bar. Here you can configure the incoming and outgoing mail accounts.

[[File:Accounts.png|250px|thumb|center|The Incoming/Outgoing Accounts Screen.]]


===Setting up Incoming Mail:===

Click on <menuchoice>Add</menuchoice>, and then ensure that ''“IMAP E-Mail Server”'' is highlighted, and then click <menuchoice>OK</menuchoice>.
After this, 2 prompts will come up offering integration with the '''KDE Wallet''' service. For convenience, select the option entitled <menuchoice>Allow Always</menuchoice>.


{|class="tablecenter vertical-centered" 
|[[Image:Add_imap_acc_edit.png|250px|thumb]] 
|Adding the new IMAP account.
|[[Image:Wallet1.png|250px|thumb]] 
|Configuring KDE Wallet.
|}

Now it is time to configure the incoming connection. Name your account ''Name'' whatever you want. Now, enter  as the '''IMAP server''' <code>''imap.gmail.com''</code>. Your Username is your email account, in this case mine is ''sync.with.kontact@gmail.com''.   The '''Password''' is the password of your Gmail account.

[[File:Configing_imap_1_edit.png‎|200px|thumb|center]]


Next, go to the <menuchoice>Advanced</menuchoice> tab, and ensure that it is connected on Port 993 with the <menuchoice>SSL/TLS</menuchoice> radio button left on. As for authentication, according to the '''KMail''' documentation, ''DIGEST-MD5 encryption is recommended, however for now Google’s IMAP server does not support any of this, so cleartext must be selected.''

Click <menuchoice>OK</menuchoice>.
Another '''KDE Wallet''' prompt should show up, and for convenience, ''you can select the <menuchoice>Allow Always</menuchoice> option.''

To check your emails, find the Inbox of your newly setup account, in this case, ''Gmail Incoming'', and press <keycap>F5</keycap> to refresh and download new emails from the server.

== Outgoing Mail Setup (SMTP Connection)==

To setup an outgoing connection, similar steps must be taken to add the new connection, which is treated as a new account by '''KMail'''. Open up the '''KMail''' Configuration window, and go to the <menuchoice>Accounts</menuchoice> area in the left navigation bar. Instead of using the <menuchoice>Receiving</menuchoice> tab, which was used to setup the incoming (IMAP) connection switch to the <menuchoice>Sending</menuchoice> tab now.

Now, click on Add... and select the <menuchoice>SMTP</menuchoice> option and click <menuchoice>OK</menuchoice>. Afterwards, a '''Configure Account''' window will appear.
The following details are needed by '''Kontact'''.

<menuchoice>Outgoing mail server</menuchoice> <code> smtp.gmail.com</code> (Check the <menuchoice>Server requires authentication</menuchoice> button) <br />
<menuchoice>Login</menuchoice> <code>'''''Your Gmail account.'''''</code> Here. it's "sync.with.kontact@gmail.com"  <br />
<menuchoice>Password</menuchoice> <code>'''''Your Gmail password.''''' </code>

For convenience, check the <menuchoice>Store SMTP password</menuchoice> option.
Now, go to the <menuchoice>Advanced</menuchoice> tab of the window and enter the following information.

<menuchoice>Encryption</menuchoice> <menuchoice>SSL</menuchoice><br />
<menuchoice>Port:</menuchoice> <menuchoice>465</menuchoice><br />
<menuchoice>Authentication</menuchoice> <menuchoice>PLAIN</menuchoice><br />

After OKing the dialog, click the <menuchoice>Set as Default</menuchoice> button to make the newly added connection the default.

When sending your first email from '''Kontact''', you will need to save the information in '''KDE Wallet''' once so it won’t have to be used later.

=== GIF Animation ===

{{Note|1=Click the image below to watch the GIF Animation which displays this process in sequence for convenience}}



Congratulations, now you can fully send and receive mail through '''Kontact'''!

[[File:Steps_to_set_up_smtp.gif‎|center|400px|link=Steps_to_set_up_smtp.gif]]

[[Category:Office]]
[[Category:Internet]]