Help:Email in Cloud VPS

This page is currently a draft.
Material may not yet be complete, information may presently be omitted, and certain parts of the content may be subject to radical, rapid alteration. More information pertaining to this may be available on the talk page.

This page contains information on best practices for managing email in Cloud VPS.

We use the word email here as a way to refer to the several protocols involved in modern and secure email exchange (smtp, spf, dkim, dmarc, pop, imap, etc).

There are some considerations you need to take into account when planning to use these emails protocols inside Cloud VPS.

Best practices

A collection of best practices.

Using Cloud VPS smtp servers

All Cloud VPS VMs have a mail relay running, so in most cases you can set the SMTP host to localhost and port to 25. Those are set to relay mail via mx-out-a.wmcloud.org and mx-out-b.wmcloud.org.

Sending emails from a Cloud VPS domain

If you send emails from a software running inside Cloud VPS, and you configure the software the use From: address that belongs to a Cloud VPS domain (such as wmflabs.org or wmcloud.org), make sure you are using the appropriate relay smtp server (see section above).

Not using our smtp relay servers when using a *@wmcloud.org or *@wmflabs.org sender address can result in SPF errors in the destination smtp server refusing your emails. Gmail for example will reject all inbound messages that fail SPF verification.

Sending emails from a non-Cloud VPS domain

If you need to send emails from a software running inside Cloud VPS, and you need a From: address that does not belongs to a Cloud VPS domain (such as wmflabs.org or wmcloud.org) so people reading the email replies to a different address, this is our recommendation.

Use a From: address from a Cloud VPS domain, such as noreply@wmflabs.org. Include a Reply-to: address in your desired external domain.
Use CloudVPS smtp servers as relay.

Example:

TODO: write an example email

Best practices

Using Cloud VPS smtp servers

Sending emails from a Cloud VPS domain

Sending emails from a non-Cloud VPS domain

See also