Skip to Content
Browse documentation

Configure a UAPP SMTP Smart Host

Configure and test an outbound domain relay with TLS, authentication, retained credentials and stale-setting protection in UAPP.

Open Hosting → Email → SMTP Smart Host. Email must be enabled and Smart Host must not be explicitly off. The provider must enable backend support; domain ownership and active account/session identity are checked.

The list distinguishes configured Enabled/Disabled state from effective Domain relay, Global relay, Direct delivery or Unavailable policy.

Relay fields

FieldRequirement
DomainSelected owned domain.
Enable domain relayEnables the domain-specific relay configuration.
Relay hostname or IPRequired valid destination when enabling; maximum 253 characters.
SMTP port1–65535; initial value 587.
EncryptionRequired STARTTLS or Implicit TLS.
Require SMTP authenticationEnables authenticated relay use.
UsernameAuthentication identity, maximum 1024 characters.
PasswordMaximum 1024 characters. Leave blank to retain the saved password.
Clear saved passwordExplicitly clears the stored credential; do not select it when intending to retain one.

Required credentials and settings are validated by the task worker. Saved passwords are not returned as recoverable form values. Use the relay provider's actual port, encryption and authentication requirements.

Save, test and remove

Load the domain, edit the settings and choose Save or the connection test. A successful probe verifies connection, TLS verification and authentication; no email is sent. It does not prove sender authorization, successful mail delivery or recipient acceptance.

Enable/disable and delete actions manage domain relay configuration. Disabling or deleting it can change the effective policy to provider-global relay or direct delivery, depending on provider configuration. Reload and inspect the resulting policy.

Writes and probes are blocked in demo mode. Operations carry the loaded settings revision: if settings changed, reload and reconcile rather than resubmitting stale values.

This configures outbound relay behavior, not inbound MX routing. Use Mail Exchange Server for local/remote inbound routing. Keep relay credentials private and verify an actual permitted test delivery after saving.