MTA-STS policy hosting repo for toppymicros.com.
This repository is intended to be published via GitHub Pages on the domain mta-sts.toppymicros.com and serve the policy file at:
https://mta-sts.toppymicros.com/.well-known/mta-sts.txt
- GitHub Pages: serve from the default branch (commonly
main) at the repository root - Custom domain:
mta-sts.toppymicros.com(seeCNAME) - HTTPS must be enabled
If you reuse this repo for your company (e.g., your company website is hosted on GitHub Pages), swap toppymicros.com to your domain everywhere:
- Update
CNAMEtomta-sts.<your-domain> - Update the policy URL to
https://mta-sts.<your-domain>/.well-known/mta-sts.txt - Update
.well-known/mta-sts.txt:- Set
mx:lines to match your domain’s actual MX hosts (check withdig MX <your-domain>) - Choose
mode: testingfirst, then move toenforce
- Set
- Create the DNS TXT record at
_mta-sts.<your-domain>withv=STSv1; id=<some-id>
Path: https://mta-sts.toppymicros.com/.well-known/mta-sts.txt
version: STSv1
mode: testing
mx: mail.protonmail.ch
mx: mailsec.protonmail.ch
max_age: 86400
Create a TXT record:
- Name/Host:
_mta-sts.toppymicros.com(or_mta-stsif your DNS provider appends the zone) - Type:
TXT - Value:
v=STSv1; id=20260106T000000Z
After publishing, verify:
dig TXT _mta-sts.toppymicros.com +shortAlso verify the policy is reachable over HTTPS:
curl -i https://mta-sts.toppymicros.com/.well-known/mta-sts.txtmode: testingis a safe rollout; switch toenforceonce confident.max_ageis 1 day; increase (e.g., 604800) after validating delivery.- Update
idwhen the policy changes to force re-fetching by senders.
If you want to reuse this repo for your company domain, replace toppymicros.com with your domain and update:
CNAMEtomta-sts.<your-domain>.well-known/mta-sts.txtmx:lines to matchdig MX <your-domain>- DNS TXT
_mta-sts.<your-domain>tov=STSv1; id=<some-id>(bumpidwhenever the policy changes)
- Added
.well-known/mta-sts.txtwith Proton Mail MX hosts,mode: testing, andmax_age: 86400. - Added
.nojekyllso GitHub Pages serves the.well-knownpath. - Documented the required TXT at
_mta-sts.toppymicros.comand policy details above.
MIT: see LICENSE.