More results...

Generic selectors
Exact matches only
Search in title
Search in content
Post Type Selectors
docs
betterdocs_faq

Mailgun Set up

Updated on December 21, 2023

Integrating the email service to Classter is very important in order to get communications running for your institution.

The mailing service is offered by Classter through our account with Mailgun.

The services offered by Mailgun is a transactional one, it allows for single or bulk emailing as well as automated emails. You also have the option of using your own Mailgun account. (www.mailgun.com)

Let’s take a look at how we set this up. Follow the path: Dashboard > Configuration > Advanced Configuration > Third-Party Integrations > Email Settings Button (Figure 1).

 

Figure 1

 

  • Here you can see all the available integrations for Classter (Custom Integrations are available as well but are not included here).
  • Click on E-mail Settings (Figure 1) to enter the integration page for the Email Service (Figure 2).

 

 

Figure 2

 

  • On this page you can see two options. Use Classter Account (Classters Mailgun Account) which offers up to 10,000 emails a month. Use your own Account, which involves using the account you have created (Paid or Free Mailgun Account).

 

Note: If you choose to create and use a Mailgun Account, we do not recommend using a free account as it uses a shared IP address, and it may create issues (Figure 2).

Note: We also recommend that you use a subdomain when setting up Mailgun, e.g. mg.mydomain.com as stated in Figure 2.

 

Use Classter Account

If you use Classter account for Mailgun integration, it’s necessary to fill your domain in the field below:

Figure 3

 

You can enter:

  • Your domain name, e.g., “yourdomain.com”
  • Or you can create a subdomain for this purpose, e.g., “mg.yourdomain.com”

 

We strongly recommend using a subdomain for this purpose, to be sure that your existing domain email will not be affected.

 

Configuration using your domain (and not a subdomain)

 

Please, be sure that you have configured the following properly:

  • On your own Email Server (Receive and Send):
    This server handles both incoming and outgoing emails (and you have already configured it).
    1. Confirm that you have set properly MX Records:
      Ensure that the MX (Mail Exchange) records for your domain point to your Server. This tells other mail servers where to send emails for your domain.
    1. Configure Inbound Mail Server:
      Set up your mail server software on your Server to handle incoming emails for your domain.
  • Classter configuration (Mailgun integration) (only send):
    Please, be sure that you have set all TXTs and CNAME records provided from Classter to your DNS Hosting provider. You should NOT include MX records provided.

 

 

General Considerations:

SPF Records:
Update the SPF (Sender Policy Framework) records for your domain to include both servers. This helps prevent email spoofing.

DKIM and DMARC:
If you have DKIM (DomainKeys Identified Mail) and DMARC (Domain-based Message Authentication, Reporting, and Conformance) configured, ensure that both servers are accounted for in these settings.

Testing:
Test the configuration by sending and receiving emails from both servers to ensure that everything is functioning as expected.

Note:
Some mail server software may have specific features or configurations for split domain setups, so be sure to consult the documentation for your chosen mail server software for any additional steps or considerations.

Always keep in mind that the specific steps can vary based on the mail server software you are using, so it’s important to refer to the documentation provided by the software’s developers for accurate and detailed instructions.

 

Configuration creating a subdomain

 

Subdomain is of the form “mg.yourdomain.com”.

Please, be sure that you have created the subdomain to your DNS Hosting Provider, and you have set all DNS records provided from Classter.

You must include all TXTs, CNAMEs and MX records provided.

 

 

No other configuration is required.

 

 

Use your own Account

To use your own account, you follow the same steps as when you use the Classter account, with one additional step in the beginning. Go to the main page (Figure 25).

 

Figure 25

 

  • Choose the ‘Use your own Account’ option (Figure 25).
  • Enter your API KEY (Figure 25). You will find the API KEY and validation key from the API KEYS tab in your Mailgun Account menu (Figure 26).
  • Select your location/country from the dropdown menu (Figure 25).
  • Enter your Domain in the Domain field (Figure 25).
  • Click on ‘Save’ button (Figure 25).

 


Figure 26

 

Figure 27

 

  • Configure your Institution’s Email-Server (Name Server) and then add the DNS Records you see in this page (This is done to verify the email server is indeed yours) after you have saved the actions from the previous step (Figure 27).
  • Once your DNS records are confirmed, the status of the files will change from ‘Unknown’ to ‘Valid’ (Figure 28).


Figure 28

 

Lastly, once you have validated your DNS Records, you will see a new section below where you can enter the email you want to be used in the Name field and then by clicking on the default button next to the email you entered (Figure 29).

Click on “Save” to save changes (Figure 27).

 

Figure 29

 

When you use the Message Center to send emails, you will be using your Mailgun account or Classter’s Mailgun account (Figure 30).

 


Figure 30

 

 

Useful tools confirming your configuration

https://www.mail-tester.com/
It’s a tool confirming all email settings configuration.

You send an email from Classter to the email address generated.
It also produces a report that gives you some recommendations that may help you to improve your score/configuration.

https://mxtoolbox.com/
It’s a tool confirming MX records set to your DNS Hosting provider. You fill your domain/subdomain set on Classter.

 

 


 

Tip: Learn about multiple addresses here.

Was this article helpful?