<!-- https://docs.elchi.dev/emx-mail-apps | EMX | Elchi Docs -->

# EMX in mail apps

Every mail app works with EMX; most need nothing but the address.

## The settings

| | |
|---|---|
| Incoming (IMAP) | `mx.emxmail.ch`, port 993, SSL/TLS (or 143 with STARTTLS) |
| Outgoing (SMTP) | `mx.emxmail.ch`, port 465, SSL/TLS (or 587 with STARTTLS) |
| Username | your address |
| Password | an app password |

Your account password never goes into a mail app. Under Settings, Mail
apps in the web client you make an **app password** per device, shown
once, revoked on its own. A password made for the phone can be revoked
when the phone is lost without touching anything else.

## Apple: one tap

On an iPhone, iPad or Mac, press **Apple profile** in the same settings.
EMX makes an app password for the device and hands you a configuration
profile with the account inside; installing it sets up Mail. The profile
is not signed, so the device says so once. Removing the profile removes
the account; revoking the app password does the same from our side.

## Thunderbird, Outlook and the rest

Type your address. Thunderbird and the apps that share its format read
`autoconfig.<your domain>`; Outlook reads `autodiscover.<your domain>`;
both names are CNAMEs to us that the DNS assistant in the admin
interface writes with the other records of the domain. The domain's DNS
also carries SRV records for IMAP and submission (RFC 6186) for apps that
look there.

## What the app sees

The folders are the ones in the web client, with their roles announced
(SPECIAL-USE), so an app files sent mail and drafts in the right place
without being told. Flags are shared: a message read on the phone is read
in the browser, and the other way round, within the second. Snoozed and
Screener are folders like any other to an app.

The shared mailboxes you are a member of appear in the app beside your
own, with the rights you have in them.

A **sealed** mailbox cannot be read by a mail app: its messages are
ciphertext that only the person's own devices can open, in the web client.
The app is told so at sign-in.

EMX has no calendar and no contacts, so there is nothing to set up for
CalDAV or CardDAV, and no Exchange ActiveSync: Outlook and the phone's
mail app connect over IMAP.

## Limits

Uploads over IMAP (a mail app filing a sent message, an import) count
against the mailbox's storage and the message size limit, 50 MB. Sending
from an app goes through the same rules as the web client: sender rights,
the daily and monthly limits, DKIM signing.
