Documentation

SMTP

Servd offers a direct integration with ElasticEmail to provide almost-zero-config email deliverability for transactional emails.

We've partnered with ElasticEmail to offer this service for free for all subscribed projects, with optional addons to increase the number of emails that you can send per month.

Getting Started

  1. Visit the Project Settings > SMTP page in the dashboard

  2. Enter the email address, password and sending domain that you'd like to use for your new ElasticEmail account.

    You'll use these details to log into ElasticEmail in the future if you ever need to review your email analytics.

  3. We'll set up your ElasticEmail account and get everything configured for you in the background.

Configuring Craft

Once your SMTP account is enabled Servd will automatically begin adding the following environment variables to all of your environments:

SERVD_SMTP_HOSTNAME
SERVD_SMTP_PORT
SERVD_SMTP_USERNAME
SERVD_SMTP_PASSWORD

We can use these within Craft's Email settings in order to get everything up and running.

If you're using Craft's 'Project Config' you'll need to perform the following steps in your local development environment:

  1. Add the SERVD_SMTP_ environment variables to your local development project.

    You can find the names, raw values and a handy .env snippet at the top of the Project Settings > SMTP page in the Servd dashboard.

  2. Visit the Craft Control Panel for your locally running project and navigate to the Settings > Email page.

  3. Check that the System Email Address uses an email that matches the 'Sending Domain' you configured for your ElasticEmail account earlier.

  4. Add the following additional configuration details:

    Reply-To Address: Any address that you'd like replies to be sent to.

    Sender Name: The name you'd like to appear as the Sender on your emails.

    Transport Type: SMTP

    Host Name: $SERVD_SMTP_HOSTNAME

    Port: $SERVD_SMTP_PORT

    Use authentication: Yes

    Username: $SERVD_SMTP_USERNAME

    Password: $SERVD_SMTP_PASSWORD

    Encryption Method: TLS

    Timeout: 10

  5. Hit 'Test' and an email should be successfully sent to the email address for the user you have used to log into the Craft Control Panel.

Verifying Your Domain (DKIM, SPF, DMARC)

In order to get emails into your recipient's inboxes, and not flagged as spam, you'll need to set up DKIM, SPF and DMARC, but don't worry! It's simply a case of adding a few DNS records to your sending domain.

The records you need to add can be found on the Project Setting > SMTP page in the Servd Dashboard. As every DNS provider is a little different, please refer to your DNS provider's documentation for detailed instructions on how to add these records to your account.

Once they have been added, return to the Servd Dashboard and click the 'Verify' button next to each of the records to check that they have been set and activate their associated functionality.

If you already have SPF records set

If you're already sending emails from the same domain via another platform, you might already have SPF DNS records defined. If that is the case do not delete the existing ones. Instead you can combine the contents of the existing record with the new value from the Servd Dashboard.

For example, if your domain already has the record: v=spf1 a mx include:_spf.google.com ~all, then you would just add: include:_spf.elasticemail.com.

The final record would look like this: v=spf1 a mx include:_spf.google.com include:_spf.elasticemail.com ~all.