Skip to content
DMARC Pulse

Email errors

MTA-STS Policy Is Missing: What STSFetchResult.NONE Means

MTA-STS policy is missing: STSFetchResult.NONE means no usable _mta-sts TXT record was found. See why Mail-in-a-Box shows it and how to fix it.

What this means

MTA-STS policy is missing: STSFetchResult.NONE means a lookup of the TXT record _mta-sts.example.com found nothing usable. That exact line comes from System > Status Checks in Mail-in-a-Box, a self-hosted mail server. MTA-STS (RFC 8461) lets a domain tell sending servers to expect an encrypted, certificate-checked connection.

A missing MTA-STS policy does not bounce mail by itself: senders deliver without that protection (RFC 8461). An unexpired cached policy still applies.

STSFetchResult.NONE versus FETCH_ERROR

  • STSFetchResult.NONE concerns DNS. The name has no TXT data, no record begins with v=STSv1, more than one does, or the record has no id.
  • STSFetchResult.FETCH_ERROR means the DNS lookup timed out or failed, or the record is fine and the policy file could not be fetched or is invalid.

Why it happens

Mail-in-a-Box writes the record itself, and only when the domain has email addresses and the certificates for the box hostname and mta-sts.example.com are signed and valid.

  • The mta-sts certificate was never issued. A self-signed one does not count.
  • A certificate is close to expiry. The test fails at 10 days or fewer, so the record leaves the zone at the next DNS rebuild.
  • DNS has not been rebuilt. Provisioning a certificate does not do it. A daily job or a setup run does.
  • DNS is hosted elsewhere. Mail-in-a-Box cannot edit your zone.

On other mail servers, the record may never have been published.

How to fix it

On Mail-in-a-Box

  1. Check DNS from outside. Run nslookup -type=TXT _mta-sts.example.com 1.1.1.1 with your domain. You want exactly one answer beginning with v=STSv1. Remove any extras.

  2. Check both certificates. In System > TLS (SSL) Certificates, click Provision if the list beside the button includes mta-sts.example.com or the box hostname. The name must resolve to the box. With DNS hosted elsewhere, first add the mta-sts A record shown on System > External DNS, and its AAAA record too if that page lists one.

  3. Choose the mode. The default is enforce. Caution: under enforce, senders that apply MTA-STS will not deliver to a host that fails certificate or MX checks. To observe first, set MTA_STS_MODE=testing in /etc/mailinabox.conf. testing shows failures only if the domain publishes TLS-RPT, so add this TXT record at _smtp._tls.example.com, in System > Custom DNS or at your external DNS host:

    v=TLSRPTv1; rua=mailto:dmarc@example.com

  4. Rebuild DNS. If you changed the mode in step 3, run sudo mailinabox over SSH, even with external DNS: the daily job rebuilds DNS but does not rewrite the policy file. If you kept the mode, you can wait for the daily job instead. With external DNS, copy the _mta-sts TXT record from External DNS once the certificates are valid.

On any other mail server

  1. Publish the policy file first. Serve it at https://mta-sts.example.com/.well-known/mta-sts.txt as text/plain, with status 200, no redirect and a valid certificate for that name. Put each host from your MX lookup on its own mx line.

    version: STSv1
    mode: testing
    mx: mail.example.com
    max_age: 604800
    
  2. Publish the TXT record second, at _mta-sts.example.com. Use your own id of 1 to 32 letters and digits, and change it whenever the file changes.

    v=STSv1; id=20160831085700Z;

  3. Stay in testing until TLS-RPT reports show no failures for any MX host. To receive them, publish a TXT record at _smtp._tls.example.com:

    v=TLSRPTv1; rua=mailto:dmarc@example.com

    Caution: under enforce, a real server with no mx line, or an expired certificate, can stop mail from senders that apply MTA-STS.

Confirm the fix

  1. Repeat the nslookup check. Public DNS can take several hours to update.
  2. Open the policy URL. It should load with no redirect or certificate warning.
  3. Run the MTA-STS checker. It validates the record and the file, then compares the mx lines with your real MX hosts.
  4. On Mail-in-a-Box, reopen System > Status Checks. With enforce, the passing line is MTA-STS policy is present. With testing, expect the error MTA-STS policy is present but has unexpected settings, which is normal until you switch to enforce.

Check it now

Test MTA-STS policy and TLS-RPT, and generate both

Frequently asked questions

What does STSFetchResult.NONE mean?
The MTA-STS lookup found no usable TXT record at _mta-sts on your domain. In postfix-mta-sts-resolver, the library Mail-in-a-Box calls, that covers a name that does not exist or has no TXT data, no record beginning with v=STSv1, more than one such record, or a record with no id. Problems with the HTTPS policy file return FETCH_ERROR instead.
Will a missing MTA-STS policy stop my email from arriving?
Not by itself. RFC 8461 tells senders to treat a domain with no usable record as having no policy, so delivery continues without MTA-STS protection. A sender that still holds an unexpired cached policy must keep applying it, so a record that vanishes from a domain in enforce mode can still affect delivery until that cached policy expires.
Why did this error appear on a Mail-in-a-Box server that used to pass?
Check the certificates first. Mail-in-a-Box publishes the _mta-sts record only while the certificates for the box hostname and the mta-sts subdomain are valid, and that test fails when 10 or fewer days remain. Renewal normally runs 14 days before expiry, so the error can point to a renewal that did not complete.
How do I fix MTA-STS policy is missing: STSFetchResult.FETCH_ERROR?
Open https://mta-sts.example.com/.well-known/mta-sts.txt with your domain. The file must load with status 200 and no redirect, as plain text, over a valid certificate, with valid fields. FETCH_ERROR can also mean the DNS lookup timed out. The check runs on the box itself, so also confirm the box can reach its own public address.
Do I need MTA-STS?
It is optional. Mail-in-a-Box labels the record Optional on its External DNS page, even though its status check shows a missing policy as an error. In enforce mode, MTA-STS tells senders to refuse delivery when a mail server offers no STARTTLS or cannot prove its identity. Your mail servers need valid certificates before you turn it on.
What does MTA-STS policy is present but has unexpected settings mean?
The Mail-in-a-Box check found a valid policy, but it expects mode: enforce and an mx list holding only the box hostname. Anything else prints this line. It is expected if you set MTA_STS_MODE=testing.

Sources consulted

RFC 8461 §1 Introduction
checked 2026-11-08

Related pages

Keep it healthy

Know the moment something breaks

Point your DMARC reports to DMARC Pulse and see who sends email as your domain, what fails and why — with a calm alert when anything changes.

Free plan: 1 domain, no credit card.