Setting up DKIM

What you need
- A Mailflux mailbox on your own domain.
- Access to the DNS management at your domain registrar or hosting provider.
- The exact DKIM value for your domain, including the correct selector. It's ready in your Mailflux account. The key is unique per domain, so copy it literally and don't make anything up yourself.
Setting up DKIM: step by step
- Log in to your domain registrar and open the DNS management.
- In your Mailflux account, find the DKIM details for your domain: the selector, the name of the record and the long key value.
- Click Add record and choose TXT as the type (with some registrars this is called a CNAME; follow what Mailflux indicates).
- Under Name (or Host), enter the selector name, in the form
selector._domainkey. The exact selector is in your account. - Under Value, enter the full DKIM key. The form is
v=DKIM1; k=rsa; p=[long key], but you copy the actual key from your Mailflux account. - Save the record. Leave the key exactly as it is; a single missing character makes the signature invalid.
DKIM works best together with SPF and DMARC: together they show that your mail really comes from you. If you want to understand what happens under the hood, what is DKIM explains it calmly. The complete overview of all records is in email DNS records explained.
Why that long key has to be so precise
The key value in a DKIM record is long, sometimes a few hundred characters. That's normal: it's the public half of a key pair, and receiving servers use it to check the signature on your mail. Precisely because it's such a long string, it's easy to make copying mistakes. Copy the whole value in one go, without line breaks or extra spaces in between. If even one character is missing, the check fails and your mail is seen as unsigned.
Some registrars automatically split such a long value into chunks between quotation marks. That's fine, as long as you copy it the way Mailflux indicates. It only goes wrong if you add or leave out characters yourself.
Checking whether it worked
Once the change has been applied, you can use an online DKIM check on your selector to verify that the key has been published correctly. Then send a test email to an address at another provider and check in the message details whether DKIM shows as pass. If you see that, every email you send from now on gets a valid signature.
Not working?
- The signature isn't recognised. The DNS change may not be active yet. Give it up to 24 hours and then test again.
- The key is cut off. Some registrars truncate long values. Check that the full key has been saved, from
v=DKIM1to the last character. - The selector name is wrong. The name must match the selector in your Mailflux account exactly, including the
._domainkeypart. - You accidentally added quotation marks. Some registrars do that automatically, others don't. Copy the value the way Mailflux indicates.
Done, and need help?
Once your DKIM record is active, every email you send gets a valid signature and you're seen as a trustworthy sender. If you're also going to use your mailbox in a program, you'll find the details at the IMAP server settings. Do you find working with DNS keys nerve-racking? We understand that completely. Let us know and we'll take a look with you or simply set DKIM up for you.