PUBLIC-INBOX-MDA(1)

📦
version 2.0.0~20230714git590023f · 6 versions
, in fedora 43, fedora 44

💌 public-inbox-mda — the mail delivery agent for public-inbox, bestie edition

okay so picture this: public-inbox-mda is the little guy who catches your mail and tucks it into bed inside a public-inbox installation. it's the MDA, the mail delivery agent. every system user can have their own public-inbox instances, and you can totally trigger this thing from procmail(1) or whatever similar tool you're rocking. 💅

by default it leans on spamc(1) to do the spam filtering, but you can turn that off with "publicinboxmda.spamcheck" over in public-inbox-config(5). slay.

✨ SYNOPSIS ✨

public-inbox-mda </path/to/RFC2822_message

like, you just feed it the RFC2822 message on stdin and it goes to work. 🎀

🦋 DESCRIPTION 🦋

it's the Mail Delivery Agent (MDA) for public-inbox installations, periodt. each system user gets to have their very own public-inbox instances, main character energy all around. you may invoke this via procmail(1) or similar tools.

by default, it relies on spamc(1) for filtering mail, but that can be disabled via "publicinboxmda.spamcheck" in public-inbox-config(5). no cap.

💅 OPTIONS 💅

  • --no-precheck — okay so by default public-inbox-mda runs some simple checks before it even thinks about invoking spamc(1), because it's meant to receive mail before it heads off to a mailing list. but some users prefer to use public-inbox-mda to mirror mailing lists instead, and this option exists to support those users. 🫶

using this option, the following prechecks get disabled:

  • multiple Message-IDs
  • non-existent Message-IDs
  • Message-IDs longer than 244 characters long
  • From: header shorter than 3 characters
  • Subject: header shorter than 2 characters
  • unusable Date: headers
  • inbox address specified in To: or Cc: header

🌸 ENVIRONMENT 🌸

  • ORIGINAL_RECIPIENT — the original recipient email address, set by the MTA. Postfix sets it by default, and it's untested on other MTAs. ngl, this does not have to be set if you're relying on "publicinbox.$NAME.listid" directives configured in public-inbox-config(5). iykyk.
  • PI_CONFIG — per-user config file parseable by git-config(1). see public-inbox-config(5) for the deets.

Default: ~/.public-inbox/config

  • PI_EMERGENCY — emergency Maildir destination. 🚨 iconic, honestly.

Default: ~/.public-inbox/emergency/

💜 CONTACT 💜

feedback is welcome via plain-text mail to <mailto:meta@public-inbox.org> — they literally want to hear from you bestie, don't be shy.

the mail archives are hosted at <https://public-inbox.org/meta/> and <http://4uok3hntl7oi7b4uf4rtfwefqeexfzil2w6kgk2jn5z2f764irre7byd.onion/meta/> 🌈

Copyright 2013-2021 all contributors <mailto:meta@public-inbox.org>

License: AGPL-3.0+ <https://www.gnu.org/licenses/agpl-3.0.txt>

⭐ SEE ALSO ⭐

git(1), git-config(1), public-inbox-v1-format(5)

go forth and deliver that mail, bestie 💖

and that's the whole vibe check from public-inbox.git, dated 1993-10-02 🎀✨

📦 where this page comes from