README

Account emails for your Flarum forum, sent through Link Robins with one key.

The first wall a new forum owner hits is email. Shared hosts block SMTP ports, Gmail throttles, SPF and DKIM are a mystery, and the forum looks broken before it has a member. Swoop takes that away: paste one key and your forum's account emails go out over HTTPS on port 443, the same port your site already serves on. No SMTP, no DNS records, no third-party account.

What it carries

The three emails a forum cannot function without:

• Confirm your account
• Reset your password
• Confirm a new email address

Notifications and digests still use your own mail settings. They come later.

Install

composer require linkrobins/flarum-swoop

Then paste your key under Admin → Swoop. Saving checks it immediately, so you know it works before a new member finds out for you.

The panel there says whether the key was accepted, and prints what the service replied when it was not. There is also a Service address, which is https://linkrobins.com and which you should leave alone unless you have been given a different one.

Choosing it

Swoop is a mail driver, so you pick it in Admin → Email the way you would pick SMTP. From then on it carries everything the forum sends — account mail, notifications, whatever an extension sends — all of it written by Flarum and delivered by us.

Being the driver means it is the forum's mail. If the service is unreachable, mail fails, exactly as it would with an SMTP host that stopped answering. Earlier versions intercepted three emails and fell back to your own settings; that was safer and much less useful.

Two more things worth knowing before you pick it. The From address is ours, not yours — mail goes out as your forum's own name on our sending domain, so the address in Admin → Email is not used while Swoop is the driver. And attachments are not carried yet: a message with one is refused rather than sent without it, because an email saying "see attached" with nothing attached is worse than a failure you can see.

Your forum writes the email, we deliver it

The message is Flarum's own — its templates, its wording, its footer, and its translations. It is rendered by your forum, in the recipient's language, so a German member reads German even on an English forum. Nothing is re-written on our side and nothing carries our branding.

What stops a leaked key becoming a spam relay is not that we write the message, but that every link in it must point at your forum. A message carrying any other destination is refused, and a plain account email only ever links back to itself, so nothing legitimate is ever turned away. Spam without a payload link is not worth sending. The sender is never yours to choose, sizes are capped, and your key sends on its own dedicated mail server, so anything that does go wrong stays with your forum rather than everyone else's.

License

MIT