CATCHMAIL(1)

💌 CATCHMAIL — it's giving sendmail, but it's actually a lil mail forwarder for MailCatcher ✨

okay bestie, welcome to catchmail(1), a User Commands moment 💅

---

🎀 NAME 🎀

catchmail — a sendmail-like interface whose whole job is forwarding your mail over to MailCatcher 🦋

---

✨ SYNOPSIS ✨

catchmail [options] [recipient ... ]

---

🌸 DESCRIPTION 🌸

So here's the vibe: MailCatcher runs a super simple SMTP server that catches literally any message you send to it and shows it off in a web interface. Iconic behaviour, no notes. 👑

To make the magic happen you:

1. run mailcatcher
2. set your fave app to deliver to smtp://127.0.0.1:1025 instead of your default SMTP server
3. go peek at http://127.0.0.1:1080 to see all the mail that's arrived so far 🫶

And catchmail? It accepts messages and forwards them to the running mailcatcher instance. That's it, that's the whole main character job. 💖

---

💅 OPTIONS 💅

okay so here's the full roster, no skips, no cuts, all facts preserved because that's the rule:

• -f FROM — sets the sending address. You're picking who it's from, periodt. ✉️
• -h, --help — displays help information. When in doubt, ask the tool itself, bestie. 🙈
• --ip IP, --smtp-ip IP — sets the IP address of the mailcatcher service. Default: 127.0.0.1 — so like, the localhost classic. 🏠
• -oi — ignored, for compatibility. It's just there to be polite to old scripts. Not me ignoring it, the program ignores it. 💀
• -q — ignored, for compatibility. Same energy, still just chillin'. 🍓
• --smtp-port PORT — sets the port of the mailcatcher service. Default: 1025 🔌
• -t — ignored, for compatibility. Three for three on the "we pretend it's here" squad. ✨
• -x, --no-exit — can't exit from the application. Literally cannot leave. It's trapped, and honestly? Relatable. 😭

---

📝 NOTES 📝

On Debian systems, the default mailcatcher configuration matches the SMTP IP and PORT defaults above. 🌈

so yeah, if you're on Debian, the defaults line up and you don't gotta lift a finger. lowkey blessed. 🧚

---

👀 SEE ALSO 👀

• mailcatcher(1) — go read that one too, iykyk 💜

---

and that's the whole page, bestie!! 🎀✨ this was mailcatcher 0.10.0, dated September 2025 — catch you in the group chat, mwah 💋🦋🔥