[Skip Navigation]

The Add Mail Account and Edit Mail Account forms let you attach an external mail account (such as Gmail, Outlook.com, Yahoo, iCloud, AOL, Fastmail, or any IMAP/SMTP server you have credentials for) to your Yioop login. Once attached, the account appears in the sidebar of the Mail activity and you can read and compose messages through it from inside Yioop.

This page is only available when the administrator has set the Mail Services mode to External Mail Accounts or MailSite and External Mail Accounts.

  1. Provider
  2. Name
  3. Incoming Mail (IMAP)
  4. Outgoing Mail (SMTP)
  5. Self-signed certificates (IMAP and SMTP)
  6. Save and Cancel
  7. Clone to Local Mailbox

Provider

A drop-down with presets for the major providers. Selecting a preset fills in the IMAP host, IMAP port, IMAP connection type, SMTP host, SMTP port, and SMTP connection type for you and hides the manual-configuration fields below. Choose Custom when none of the presets fit (a corporate mail server, a self-hosted IMAP server, or any provider not listed).

The current presets are Gmail, Outlook.com, Yahoo, iCloud, AOL, and Fastmail. The preset fills hosts and ports only; you still need to enter the username (or email) and password yourself.

Name

A short label for this account. It appears in the sidebar account list and in the From: dropdown when composing. Pick something that helps you tell accounts apart at a glance, such as "Work Gmail" or "Personal iCloud".

Incoming Mail (IMAP)

These fields configure how Yioop reads messages from the source server. Shown only when the Provider is Custom; the preset providers fill them automatically and hide them.

Host
Hostname of the IMAP server, for example imap.example.com. Do not include the protocol prefix.
Port
TCP port the IMAP server listens on. 993 for implicit-TLS (IMAPS); 143 for cleartext or STARTTLS. Most modern providers require 993.
Username / Email
The credential the server expects on LOGIN. Providers labelled Email want the full email address; providers labelledUsername want just the local-part. For Custom configurations this label is just Username and you supply whatever the server accepts.
Password
The IMAP password. Many providers (Gmail, Yahoo, iCloud, AOL) require an application password separate from the account password used in their web UI; consult the provider's documentation. On the Edit form the field shows a placeholder of dots when a credential is already on file; leaving the field at the dots preserves the stored credential, typing something replaces it. Passwords are encrypted at rest before being written to the Yioop database.
Connection
TLS mode for the IMAP connection. IMAPS (implicit TLS) for port 993; STARTTLS for cleartext-then-upgrade on port 143; Plaintext is intended for testing against a server on the loopback interface and should not be used over an untrusted network.

Outgoing Mail (SMTP)

These fields configure how Yioop sends mail from this account. Shown only when the Provider is Custom.

Host
Hostname of the SMTP server.
Port
TCP port. 465 for implicit-TLS (SMTPS); 587 for STARTTLS submission; 25 is for server-to-server delivery and not usually appropriate for an end-user sending account.
Username
Most providers accept the same value as the IMAP username here. Leave blank to fall back to the IMAP username.
Password
The SMTP password. Same Edit-form behavior as the IMAP password: dots-placeholder leaves the existing credential in place; typing replaces it.
Connection
TLS mode for outgoing SMTP. SMTPS, STARTTLS, or Plaintext (test-only).

Self-signed certificates (IMAP and SMTP)

A single checkbox that accepts self-signed or otherwise non-trusted TLS certificates on the configured IMAP and SMTP connections. Leave unchecked for any account talking to a real public provider; check only when pointing at a development or internal server with a self-signed certificate.

Save and Cancel

Save validates the fields and writes the row; the password is encrypted before storage. Validation surfaces errors inline next to the affected field. Cancel returns you to the Mail activity without changes; on Edit Account this also abandons any unsaved edits.

Clone to Local Mailbox

When the Mail Services mode is MailSite and External Mail Accounts and you are editing an existing account, a Clone to Local Mailbox link appears under the heading. Clicking it replaces the settings form with a one-shot clone-submission form that copies messages from this external account into your local MailSite inbox. See the Mail Clone page for details.

X