Mailopus documentation

For people running their own Mailopus server. Mailopus runs on Cloudflare today, in your own account.

Start here

  1. Set up your server. Requirements, deploy, DNS, Email Routing, Email Sending and claiming it with a passkey.
  2. Addresses and domains. Adding addresses, + aliases, the catch-all route, more domains, more people.

Using it

  • Sign-in and discovery. How app.mailopus.net finds your Worker, where passkeys and sessions live, adding a device, recovery.
  • Mail apps. Running the IMAP and SMTP proxy, app passwords, and setting up Apple Mail, Thunderbird and Outlook.
  • Spam. What goes to Junk, blocked senders, remote classifiers, writing your own rules.
  • Configuration. Every variable, secret and binding, notifications, Swiftly signatures, Gmail import, backups and JMAP for other clients.
  • Troubleshooting. Symptoms and fixes, from deploy to mail apps.
Copyright © 2026