> For the complete documentation index, see [llms.txt](https://xoops.gitbook.io/xoops-operations-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://xoops.gitbook.io/xoops-operations-guide/the-admin-interface/preferences/mail-setup.md).

# Mail Setup

This section of the control panel is used to configure your email for the system. It is recommended that you leave the Mail Delivery Method on the default setting “PHP (mail)”. You do not need to fill in the Sendmail or SMTP fields unless you use an alternative mail delivery option.

| Field                | Description                                                                                                                                                                                                                  |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| FROM address         | Enter the email address you want to use for administrative purposes                                                                                                                                                          |
| FROM name            | This is the name that will be used when you send mail                                                                                                                                                                        |
| FROM user            | When the system sends a private message to a user, you can choose whom it appears to have been sent from here.                                                                                                               |
| Mail delivery method | Choose the method used to deliver mail here. The default is “PHP (mail)”. It is recommended that you do not change this unless you experience problems.The other options available are i) Sendmail; ii) SMTP; iii) SMTPAuth. |
| Path to sendmail     | Enter the path to the sendmail program (or substitute) on the webserver here (only if you use this mail delivery option). The default is “/usr/sbin/sendmail”                                                                |
| SMTP host(s)         | Enter a list of SMTP servers to try to connect to here (only if you use SMTP, otherwise leave it blank)                                                                                                                      |
| SMTPAuth username    | Enter your username to connect to an SMTP host with SMTPAuth here (only if you use this mail delivery option, otherwise leave it blank).                                                                                     |
| SMTPAuth password    | Enter your password to connect to an SMTP host with SMTPAuth (only if you use this mail delivery option, otherwise leave it blank)                                                                                           |


---

# 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://xoops.gitbook.io/xoops-operations-guide/the-admin-interface/preferences/mail-setup.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.