Adding A New Whitelabeled Cloud Domain

• Table of Contents
• Choose your Domain
• Set up the DNS
• Configure Engine
• Configure Studio
• Testing

As a GreenArrow Cloud customer, you can start sending from GreenArrow as soon as you receive the login to the server by using the domain that was used to deploy your license. In most cases, the domain will look similar to this: c123.drhinternet.net.

Because this domain is present in various places in your email, your recipients could see it. Where exactly this domain would appear to your recipients will depend on the email client they use. For example, this is how Gmail’s webmail client shows our domain in your email:

GreenArrow does have the option to Whitelabel your emails with your own domain. This document outlines the steps required to set this up.

Choose your Domain

First, you must choose which domain you’re going to use with GreenArrow. You will be updating DNS records for this domain, so you will need to choose a domain that is dedicated to GreenArrow (one that is not used for anything else). If you’d like to use a domain that you’re already using for other other applications (like for your corporate website or email), then you should choose a subdomain instead.

For example, our company is DRH Internet with our website at https://drh.net, so using drh.net to whitelabel GreenArrow would take down our existing website. Instead, we will use a subdomain that doesn’t yet exist, like cloudexample.drh.net.

Using that example domain cloudexample.drh.net, here is what your email would look in Gmail like after you finish this setup:

Notice that only the white labeled domain is present; your cloud server domain c123.drhinternet.net is no longer showing.

Set up the DNS

Next, you’ll need to set up your DNS records.

Complete all of the following:

1. Make note of the current domain name of your GreenArrow server. This will look like c123.drhinternet.net (the number 123 will be different for your server, so make sure you have your server’s domain).
2. Create a CNAME record for the subdomain you’ve chosen. If you’re using cloudexample.drh.net then here is the record you’d create: cloudexample.drh.net CNAME c123.drhinternet.net
3. Set up a DKIM Key in GreenArrow Engine’s configuration:
   1. In Engine, click on DKIM Keys under the Configure menu
   2. In the bottom right corner of the DKIM Keys configuration, click Add DKIM Key.
   3. Enter your details:
      1. Domain: This can be drh.net, or cloudexample.drh.net, whichever you’d like to use in the From Address of your emails. For this example, I’m going to use drh.net
      2. Selector: If this is your only DKIM Key on drh.net then you can use the selector provided. If you already have a DKIM Key that is using default as the selector, then you’ll need to choose another.
      3. Default for domain: Yes, if no default key already exists for this domain
      4. Generate a new private key: leave checked
      5. Key Bits: 1024 bits (recommended)
   4. Click Save to generate the key
   5. On the next page after saving, scroll down to DNS Record for Public Key. Use the data in those fields to create the DNS record by copying the Name and Value from GreenArrow into your domain’s zonefile.

Configure Engine

Add the domain configurations into Engine. Studio will also use these settings:

1. Create an Aliased Incoming Email Domain:
   1. In Engine, click on Domains under the Configure menu
   2. In the bottom right-hand corner of the Domains configuration, click Add Aliased Domain.
   3. Enter your details:
      1. Domain Name: Enter your domain that you used to create the CNAME record above. Using the example above it would be: cloudexample.drh.net
      2. Alias This Domain To: If there is more than one option, choose the one that matches GreenArrow’s domain used in the CNAME. Using the example above it would be: c123.drhinternet.net
   4. Click Save
2. Create the URL Domain:
   1. In Engine, click on URL Domains under the Configure menu
   2. In the bottom right-hand corner of the Domains configuration, click Add URL Domain.
   3. Enter your details:
      1. Domain: Enter your domain that you used to create the CNAME record above. Using the example above it would be: cloudexample.drh.net
      2. SSL: Leave unchecked
   4. Click Save

Configure Studio

Configure Studio to use the new domain:

1. In GreenArrow Studio, click on ADMIN | My Organization
2. Click the Edit this Organization button
3. Scroll down to PERMISSIONS
4. Select the bounce email from the domain that you just added on BOUNCE EMAIL MODE: ALWAYS USE THE FOLLOWING BOUNCE EMAIL - For our example it is [email protected]
5. Select the domain that you just added on URL DOMAIN MODE: ALWAYS USE THE FOLLOWING URL DOMAIN - For our example it is cloudexample.drh.net
6. Scroll to the bottom of the page and click on Update this Organization

Testing

We recommend testing the above configuration by sending an email to yourself. Gmail accounts are free and Google does a good job of exposing potential issues in the above configurations, so I’ll use Gmail in my testing examples. But any email service that checks for DKIM and SPF, and which allows you view the full headers of the email will work for the testing steps I have outlined below.

1. Create a test campaign in GreenArrow Studio (you can use an existing Mailing List or create a new one):
   1. Content: Create any simple content you would like. Make sure to include at least one URL.
   2. Segment: We aren’t going to send this campaign (we’re just going to use the Preview feature), so you can leave this unconfigured.
   3. Delivery Settings: Fill in at least the following:
      1. FROM NAME: Any name is fine.
      2. FROM EMAIL: Use an email address at the domain used in the Set up a DKIM Key step above. From our example, it is: [email protected]
      3. VIRTUAL MTA: System Default Route
      4. URL DOMAIN: Use the URL Domain you created in the Create the URL Domain step above. From our example, it is: cloudexample.drh.net
      5. TRACK LINKS: Yes
      6. BOUNCE EMAIL: Use the Domain you created in the Create an Aliased Incoming Email Domain step above. From our example, it is: [email protected]
   4. On the Campaign Summary Page, click the Preview button
   5. Enter your testing Gmail address and click Send this preview
   6. Check your Gmail webmail for the preview email
   7. Click on a link to make sure the redirect works as expected
   8. Verify the domains listed in the banner:
   9. View Original Message for more details:
   10. Make sure SPF and DKIM are passing:

If any of the above testing does not work or if you see a failure in any of the headers, then you’ll need to review all of the DNS changes that were made. Sometimes it is just a matter of DNS propagation (the time it takes for your DNS changes to show up out on the Internet), so you may just need to wait a few hours and test again.