> For the complete documentation index, see [llms.txt](https://docs.yeymail.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.yeymail.com/using-yeymail/sending-and-replying/apple-mail.md).

# Apple Mail

On a Mac you add the alias as an extra outgoing server, then pick it in the **From** menu when composing. Your existing inbox is untouched.

## Before you start

In YeyMail: **Aliases → open the alias → Send as this alias (SMTP)** and set a password.

## Steps

1. In Mail, open **Mail → Settings** (older versions: *Preferences*).
2. Go to **Accounts**, pick the account you read mail in, and open the **Server Settings** tab.
3. Click the **Outgoing Mail Account (SMTP)** dropdown → **Edit SMTP Server List…**
4. Click **+** to add a server and fill it in:

   | Field       | Value                                      |
   | ----------- | ------------------------------------------ |
   | Description | e.g. "YeyMail shop alias"                  |
   | User Name   | the full alias, e.g. `shop@yourdomain.com` |
   | Password    | the SMTP password you set                  |
   | Host Name   | `mx1.yeymail.com`                          |
5. Untick **Automatically manage connection settings**, then set:

   | Field          | Value    |
   | -------------- | -------- |
   | Port           | `587`    |
   | Use TLS/SSL    | ticked   |
   | Authentication | Password |
6. Click **OK**, then **Save**.

## Sending from the alias

Apple Mail ties the From address to the account, so to have `shop@yourdomain.com` appear as the sender, add it to the account's **Email Address** field:

1. **Mail → Settings → Accounts**, select your account.
2. In **Email Address**, add the alias alongside your existing address, separated by a comma. Some versions offer **Edit Email Addresses…** for this.
3. When composing, a **From** dropdown now appears. Choose the alias, and make sure the outgoing server you added above is selected underneath.

## If it doesn't work

**It hangs or says the server isn't responding**: you almost certainly have port 465. It must be `587`. "Use TLS/SSL" on port 587 means STARTTLS, which is what we want.

**Rejected when sending**: the From address must match the alias in *User Name*. If you have several aliases, each needs its own SMTP server entry with its own password, and you must pick the matching pair when composing.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.yeymail.com/using-yeymail/sending-and-replying/apple-mail.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.