Admin
Mail Server
Configure or edit email settings and messages used by the application.
Step-by-step guide
Before you start
Use an administrator account for this feature.
Open this feature
Open /admin/settings/mail-server on your application domain, or use the matching item in the application menu.
Steps
Save changes
- Open /settings/mail-server on your own application domain.
- Complete these fields in that form: Recipient Email, Sender Email, Sender Name, SMTP Host, SMTP Username, SMTP Password, SMTP Port, Encryption, Timeout (seconds), EHLO Domain, Sendmail Command. Their choices and limits are listed below.
- Select Save changes. The exact label can change between creating and editing a record.
- If validation fails, correct the named field and submit again. After success, reopen the same record and compare the saved values.
| Field shown in the form | What to enter | Example / note |
|---|---|---|
| Recipient Email | Required. Use an email address you control for a test. No more than 255 characters. | Use your controlled test inbox. |
| Sender Email | Required. Use an email address you control for a test. No more than 255 characters. | Use your controlled test inbox. |
| Sender Name | Required. No more than 255 characters. | Test record (use a unique value where required). |
| SMTP Host | Optional, unless this form asks for it. No more than 255 characters. | Use the value required by the task; no example is assumed. |
| SMTP Username | Optional, unless this form asks for it. No more than 255 characters. | Use the value required by the task; no example is assumed. |
| SMTP Password | Optional, unless this form asks for it. No more than 255 characters. Enter the real value privately; do not put it in a screenshot or support message. | Use the value appropriate to your test account; no preset is supplied. |
| SMTP Port | Optional, unless this form asks for it. Enter a whole number. At least 1. No more than 65535. | Use the value required by the task; no example is assumed. |
| Encryption | Required. Choose one of the options shown by the form. | Use the value required by the task; no example is assumed. |
| Timeout (seconds) | Optional, unless this form asks for it. Enter a whole number. At least 5. No more than 120. | Use the value required by the task; no example is assumed. |
| EHLO Domain | Optional, unless this form asks for it. Optional. Useful when your SMTP provider expects a specific domain in the handshake. No more than 255 characters. | Use the value required by the task; no example is assumed. |
| Sendmail Command | Optional, unless this form asks for it. No more than 255 characters. | Use the value required by the task; no example is assumed. |
Fields shown in the interface
Only fields traced to this role’s handler and its own view are listed. The application can show separate create/edit forms; do not fill every row on one screen.
Form 1 — fields shown in the interface
| Field | What to enter or choose |
|---|---|
| Recipient Email | Required. Use an email address you control for a test. No more than 255 characters. |
| Sender Email | Required. Use an email address you control for a test. No more than 255 characters. |
| Sender Name | Required. No more than 255 characters. |
| SMTP Host | Optional, unless this form asks for it. No more than 255 characters. |
| SMTP Username | Optional, unless this form asks for it. No more than 255 characters. |
| SMTP Password | Optional, unless this form asks for it. No more than 255 characters. Enter the real value privately; do not put it in a screenshot or support message. |
| SMTP Port | Optional, unless this form asks for it. Enter a whole number. At least 1. No more than 65535. |
| Encryption | Required. Choose one of the options shown by the form. |
| Timeout (seconds) | Optional, unless this form asks for it. Enter a whole number. At least 5. No more than 120. |
| EHLO Domain | Optional, unless this form asks for it. Optional. Useful when your SMTP provider expects a specific domain in the handshake. No more than 255 characters. |
| Sendmail Command | Optional, unless this form asks for it. No more than 255 characters. |
Check the result
After a source-checked procedure, verify the same record in the same workspace. Check saved values, visible state and access with the intended test account. An external payment/message/provider action needs its own result check.
Problems and validation
| Problem | Next step |
|---|---|
| A field rejects the value | Check its named error, the form’s visible choices and the relevant limit. Do not substitute internal numeric codes for the displayed options. |
| The control is missing | Check role, plan, enabled app and current record state. Do not grant administrator access merely to complete a User task. |
| The saved result is unexpected | Reopen the same record and verify its owner/workspace before repeating the action. |
Technical reference
Role-scoped source references
Pinned commit: 40d27448e4517301d3d8f5a27ca0c7531c51f136
Source-only route information
| Method | Source-default route |
|---|---|
| LIVEWIRE | /settings/mail-server |
| LIVEWIRE | /admin/settings/mail-server |
Unmapped fields — not user instructions
These fields belong to this role’s source handler, but their screen labels were not confirmed.
| Source key | Handler |
|---|---|
| mail_protocol | modules/AdminMailServer/Livewire/MailServerSettings.php |