# Mail and calendar apps

Voozin mailboxes work in any app that speaks IMAP, SMTP and CalDAV: Apple Mail and Calendar, Thunderbird, Outlook, Thunderbird for Android, K-9 Mail and others. Most apps find the settings themselves from the email address.

## Settings

| Setting | Value |
| --- | --- |
| Incoming (IMAP) | `imap.inboxcluster.net`, port `993`, SSL/TLS |
| Outgoing (SMTP) | `smtp.inboxcluster.net`, port `465` with SSL/TLS, or `587` with STARTTLS |
| Calendar (CalDAV) | `https://mail.voozin.com/dav/` |
| User name | The full mailbox address, for example `ann@acme.com` |
| Password | An app password for that mailbox |

The dashboard's **Connect** dialog next to each mailbox shows the same settings. Connections without TLS are refused. Mailboxes with end-to-end encryption have no CalDAV, because their calendars are encrypted in the browser.

## App passwords

Mail apps don't use your account password. Create an app password for each device:

1. In the dashboard open **Mailboxes** and click **Connect** next to the mailbox.
2. Enter a name such as "Thunderbird on laptop" and click **Create**. The password is shown once.
3. Paste it into the app as the password.

Revoke an app password from the same dialog when a device is lost. Repeated wrong passwords temporarily block the device's IP address.

## Automatic setup

Enter the email address and the app password; the app fills in the servers.

- **Thunderbird and Thunderbird for Android** read the settings from `autoconfig.inboxcluster.net`, which they find through your domain's MX record. Nothing extra is needed in your DNS.
- **Outlook** (classic, for IMAP accounts) uses autodiscover. Add this SRV record to your domain:

  | Type | Name | Priority | Weight | Port | Target |
  | --- | --- | --- | --- | --- | --- |
  | SRV | `_autodiscover._tcp` | `0` | `0` | `443` | `autodiscover.voozin.com` |

- **Other apps** that ask for servers: use the settings above.

## iPhone, iPad and Mac

In the **Connect** dialog click **Set up on iPhone or Mac**. It downloads a profile with a new app password that adds the mailbox to Mail, and to Calendar for standard mailboxes.

- **iPhone and iPad:** open the file, then go to **Settings → Profile Downloaded** and tap **Install**.
- **Mac:** open the file, then go to **System Settings → General → Device Management** (or **Profiles**) and click **Install**.

The device shows the profile as unverified because it isn't signed; that's expected. Removing the profile removes the account. The app password inside it stays valid until you revoke it in the dashboard.

## Signing in with your Voozin account

Apps that support [Sign in with Voozin](https://voozin.com/docs/sign-in-with-voozin) connect without an app password: they open a browser window where you sign in to Voozin and approve access to mail and calendars. You can disconnect them under **Account and security → Connected apps**.

Thunderbird offers this once Voozin is in its built-in list of sign-in providers; until then, use an app password in Thunderbird. Apple Mail, Outlook and Gmail only offer browser sign-in for their own list of providers, so they use app passwords.
