kurrier
Configuring Providers

SMTP and IMAP

Connect an existing mailbox to Kurrier using standard SMTP and IMAP settings.

SMTP and IMAP

Kurrier can connect to an existing mail service using SMTP and IMAP:

  • SMTP sends outgoing messages.
  • IMAP synchronizes incoming mail and folders.

Use this provider when your mail host supplies standard server settings and credentials. You can configure SMTP only for sending, or SMTP with IMAP for a complete mailbox connection.

Before you begin

Collect the following information from your mail provider or administrator:

  • Email address or account username
  • App password or mailbox password
  • SMTP host, port, and encryption mode
  • IMAP host, port, and encryption mode

Prefer an app-specific password when your provider supports one. Some providers disable password-based SMTP or IMAP entirely and require their own OAuth integration instead.

Add the connection

  1. Open Settings → Providers.
  2. Select Add Provider → SMTP/IMAP.
  3. Enter a recognizable account label.
  4. Add the SMTP settings supplied by your provider.
  5. Add IMAP settings if you want Kurrier to synchronize the mailbox.
  6. Save and verify the connection.

Typical fields include:

FieldDescription
Account labelA private name used to identify the connection in Kurrier
SMTP host and portThe outgoing mail server and connection port
SMTP username and passwordCredentials used to send mail
SMTP secureDirect TLS, normally used with port 465
IMAP host and portThe incoming mail server and connection port
IMAP username and passwordCredentials used to synchronize mail
IMAP secureTLS, normally enabled with port 993

Choose the correct encryption setting

The Secure setting describes how encryption begins:

ConnectionTypical portSecure setting
SMTP with direct TLS465On
SMTP with STARTTLS587Off; the connection upgrades with STARTTLS
IMAP with TLS993On

Use the values documented by your provider. Do not guess based only on the port if the provider gives explicit instructions.

Common configurations

Gmail with an app password

Google accounts using app passwords generally use:

SettingValue
SMTP hostsmtp.gmail.com
SMTP port465
SMTP secureOn
IMAP hostimap.gmail.com
IMAP port993
IMAP secureOn

Use the complete Gmail address as the username. The account must have two-step verification enabled before you can create an app password. Availability can depend on the Google account or organization policy.

Microsoft 365 or Outlook

Common server settings are:

SettingValue
SMTP hostsmtp.office365.com
SMTP port587
SMTP secureOff; use STARTTLS
IMAP hostoutlook.office365.com
IMAP port993
IMAP secureOn

Many Microsoft tenants disable basic username-and-password authentication. If yours does, use a supported Microsoft account integration or ask the tenant administrator which connection method is allowed.

Custom-domain mailbox

Your hosting provider may use values such as mail.example.com, SMTP port 465 or 587, and IMAP port 993. Use the exact values in the provider's control panel or documentation.

Accounts, identities, and mailboxes

Kurrier keeps these concepts separate:

  • The account contains the encrypted server connection and credentials.
  • The identity contains the address and display name used when sending.
  • The mailboxes are the folders discovered from the IMAP server.

After a successful SMTP/IMAP connection, Kurrier creates or links the appropriate identity and starts discovering folders. Initial synchronization can take longer for a large mailbox.

Troubleshooting

ProblemWhat to check
Invalid login or passwordConfirm the complete username and use an app password when required.
Connection refusedCheck the host, port, firewall rules at the provider, and encryption mode.
TLS or hostname errorUse the provider's documented server hostname rather than a custom alias.
SMTP works but IMAP failsConfirm that IMAP is enabled for the account and that its credentials are correct.
SMTP authentication fails on port 587Use STARTTLS with SMTP secure off unless the provider explicitly says otherwise.
Mailbox connects but messages are missingAllow the initial synchronization to run and confirm that the expected IMAP folders are available.

Security recommendations

  • Use app-specific credentials where available.
  • Keep TLS enabled according to your provider's instructions.
  • Do not reuse an administrator or root mailbox credential.
  • Rotate a credential immediately if it may have been exposed.
  • Never include mailbox passwords in a support request.

You can connect multiple SMTP/IMAP accounts when your workspace needs more than one mailbox or provider.

On this page