Chapter 2. Getting Started

Daniel Naber

David Rugge

Michel Boyer de la Giroday

Scarlett Clark

Revision Applications 17.08 (2017-04-18)

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 Using KMail section.

Account Wizard

Account Wizard

Account Wizard

The first time you run KMail you will be greeted with the Account Wizard.


If at anytime you need to run the account wizard again, you can find it under SettingsAdd Account.

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.

  • Provide personal data is the first screen of the wizard. It will prompt you for your basic account information: Full name:, E-mail address, and Password. By default, the Find provider settings on the Internet 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 Next button once finished.


    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.

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

    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.

  • The Select Account Type 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 Check for more on Internet button. Once your account type has been selected, click the Next button, and you will be presented with the Personal Settings screen.

    The Provide personal data screen will show again with the server details it found if the wizard was successful at determining the account type. Click the Finish set up the account, complete the wizard and close the window.

  • The Personal Settings screen will show if you had to enter your account type. Verify that your information is correct on this page. Select Download all messages for offline use if you want your messages available when you do not have an Internet connection (IMAP only). Click the Next button once finished.

  • Your account will then be set up, and you can click the Finish button to complete the wizard and close the window.

For manually creating accounts please continue reading the rest of this document.