Modern single-binary mailing list manager
  • Go 79.3%
  • TypeScript 19.4%
  • CSS 0.5%
  • Python 0.4%
  • Dockerfile 0.2%
  • Other 0.1%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-11-09 15:06:29 +01:00
docs feat(api): list policies, held queue and member bounce state 2026-11-09 15:05:11 +01:00
internal feat(api): list policies, held queue and member bounce state 2026-11-09 15:05:11 +01:00
.gitignore chore: initial project skeleton 2026-11-09 14:44:55 +01:00
Dockerfile feat: daemon entrypoint, YAML config and Dockerfile 2026-11-09 14:55:38 +01:00
go.mod feat: daemon entrypoint, YAML config and Dockerfile 2026-11-09 14:55:38 +01:00
go.sum feat: daemon entrypoint, YAML config and Dockerfile 2026-11-09 14:55:38 +01:00
parsimony.example.yaml feat: wire REST API into the daemon and document it 2026-11-09 14:57:57 +01:00
README.md feat(api): list policies, held queue and member bounce state 2026-11-09 15:05:11 +01:00

parsimony

A modern, single-binary mailing list manager: an evolution of Mailman.

  • Postfix delivers to parsimony over LMTP; parsimony relays through SMTP.
  • Discussion lists with member-only posting, List-* headers, one-click unsubscribe and DMARC-safe From rewriting.
  • Self-service subscribe and unsubscribe by email with double opt-in: send to list+join@domain or list+leave@domain, then reply to the confirmation.
  • Moderated lists: posts wait in a queue that the API can approve or discard.
  • VERP bounces: every recipient gets a signed return address; 3 hard bounces disable a member.
  • SQLite storage, one YAML config file.
  • Admin REST API under /api/v1 (see docs/openapi.yaml).

Run

cp parsimony.example.yaml parsimony.yaml
PARSIMONY_API_TOKEN=<token> go run ./cmd/parsimony -config parsimony.yaml

The API is disabled when PARSIMONY_API_TOKEN is not set.

curl -H "Authorization: Bearer $PARSIMONY_API_TOKEN" -d '{"name":"dev","domain":"example.org","title":"Dev"}' localhost:8080/api/v1/lists

Postfix

Deliver the list domains to parsimony over LMTP and keep the + extensions intact, for example:

transport_maps = hash:/etc/postfix/transport
# /etc/postfix/transport
lists.example.org  lmtp:inet:127.0.0.1:2424