# Set up mail apps and devices

> Find the settings a mail app needs, set up an iPhone, iPad or Mac with a code, and remove a device from webmail.

Source: https://docs.coritan.com/mail/webmail/mail-apps/

In the dashboard:

- /webmail/settings/apps: https://www.coritan.com/webmail/settings/apps

The **Mail apps** tab of webmail settings has what a phone or desktop mail app needs to open the mailbox: its server settings, and a code that sets up an iPhone, iPad or Mac with a password made for that device. It is at [www.coritan.com/webmail/settings/apps](https://www.coritan.com/webmail/settings/apps) for the mailbox on screen. Mail apps read mail over IMAP and send it over SMTP.

## Before you begin

- Own the mailbox or be able to send from it. Someone who **Can only read** a mailbox has no **Mail apps** tab.
- A staff mailbox opens in webmail only, so it cannot be set up in a mail app.
- When two-factor authentication is on for the mailbox, a mail app cannot sign in with the mailbox's password, because it cannot send a code. Set the app up with a code, or give it an app password.

## Find the server settings

The tab lists these settings. The copy button beside a setting copies it. For a server, it copies the name alone.

**Email address** and **Username**
: The mailbox's full address, such as `alex@coritan.gg`.

**Password**
: What the app signs in with. The row names it:
  - `Your Coritan password` for the mailbox your Coritan account came with, until it has a password of its own;
  - `The mailbox's own password` for every other mailbox, and for that one once you [change its password](/mail/webmail/security/#change-the-mailbox-password).

  An app password works for any mailbox. The owner creates app passwords on the **Security** tab.

**Incoming mail (IMAP)**
: The server that apps read mail from, with port `993` and SSL/TLS.

**Outgoing mail (SMTP)**
: The server that apps send mail through, with port `587` and STARTTLS.

**JMAP**
: The address for an app that asks for a JMAP server. Most apps do not.

**Storage** and **Largest attachment**
: How much of its storage the mailbox uses, and the largest attachment webmail takes.

Many mail apps look these settings up from your address alone. When an app asks for them, [set it up by hand](/mail/mail-hosting/connect-a-mail-app/#set-up-an-app-by-hand) with the names from this tab.

## Set up an iPhone, iPad or Mac

A code sets up the mailbox in Mail and its contacts in Contacts, with a password made for that device alone. It works for a mailbox shared with you too, so you never need the mailbox's password.

1. On the **Mail apps** tab, under **iPhone, iPad or Mac**, name the device in **Device**, or keep `iPhone`. A name can be up to 40 characters.
2. Select **Make a code**. A QR code appears.
3. Within 15 minutes, scan the code with the device's camera. On the device itself, you can select **Open the profile on this device** instead. The code works once.
4. Install the profile on the device. On an iPhone or iPad, the downloaded profile waits in the Settings app.
5. Select **Done** in webmail.

The password is made when the device opens the code. Until then, the device's row reads **Waiting for its code to be opened**. Once the device has opened it, the row reads **In use**, with the date it was set up.

## Set up another mail app

For Outlook, Thunderbird, Android and other apps:

1. Choose what the app signs in with. The owner can [create an app password](/mail/webmail/security/#create-an-app-password) for it on the **Security** tab. Without two-factor authentication, the password the **Password** row names works too.
2. In the app, add an account with the [server settings](#find-the-server-settings) from the tab. Use the mailbox's address as the username.

For a mailbox shared with you, webmail sets up only an iPhone, iPad or Mac. For another app, ask the mailbox's owner for an app password.

## Remove a device

1. On the **Mail apps** tab, find the device under **iPhone, iPad or Mac**.
2. Select the bin button at the end of its row, then confirm with **Remove device**.

We show the device's name followed by `removed.` The device stops signing in to the mailbox at once.

Each person sees only the devices they set up. The mailbox's owner also finds every device's password under **App passwords** on the **Security** tab, where a device that someone the mailbox is shared with set up shows their email address after its name. A device also stops signing in when:

- the owner removes your access to a shared mailbox, or changes it to **Can only read**;
- the mailbox passes to a new owner, for the devices the previous owner set up.

## Limits

- Each person can have up to 20 devices on one mailbox.
- Each person can make up to 10 codes an hour for one mailbox.
- A mailbox holds at most ten app passwords, and each device's password is one of them. The mail server can refuse a new device before you reach 20.

## Troubleshooting

**Its code was not opened in time**
: Nobody opened the code within 15 minutes. Remove the row, then make a new code.

`This link has been used or has expired; make a new one in the webmail`
: Each code opens once, within 15 minutes. Make a new code.

The device warns that the profile is not signed
: We do not sign the profile. Check that it names your mailbox's address, then install it.

`The mail server made no password; make a new link in the webmail`
: The mailbox may already hold ten app passwords. Remove a device you no longer use, or ask the owner to revoke an app password on the **Security** tab. Then make a new code.

`The mail server cannot be reached; try again in a moment`
: Wait a minute, then open the code again. If 15 minutes have passed, make a new code.

**Make a code** is greyed out
: The **Device** field is empty, or you have 20 devices on this mailbox. Name the device, or remove one you no longer use.

A message that ends `too many requests for this action. Please wait and try again.`
: You made 10 codes for this mailbox within an hour. Wait, then try again.

A message that ends `which checks two-factor each time; a device could not.`
: This is a staff mailbox, which opens in webmail only. Read it in webmail.

`Your devices could not be loaded.`
: Reload the page. You can still make a code.

The app says the username or password is wrong
: Use the full address as the username. If two-factor authentication is on for the mailbox, the app needs an app password, or a code for an iPhone, iPad or Mac. For more causes, see [Connect a mail app to Mail Hosting](/mail/mail-hosting/connect-a-mail-app/#troubleshooting).

## Related

- [Protect your webmail mailbox](/mail/webmail/security/)
- [Connect a mail app to Mail Hosting](/mail/mail-hosting/connect-a-mail-app/)
- [Open and share mailboxes in webmail](/mail/webmail/mailboxes-and-sharing/)
