Modern single-binary mailing list manager
- Go 79.3%
- TypeScript 19.4%
- CSS 0.5%
- Python 0.4%
- Dockerfile 0.2%
- Other 0.1%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
- Add new-list dialog with client validation and server error display - Reset the form each time the dialog opens |
||
| admin | ||
| docs | ||
| internal | ||
| .gitignore | ||
| Dockerfile | ||
| go.mod | ||
| go.sum | ||
| parsimony.example.yaml | ||
| README.md | ||
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-safeFromrewriting. - Self-service subscribe and unsubscribe by email with double opt-in:
send to
list+join@domainorlist+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.
- Archive with full-text search (SQLite FTS5) and threading. Each list has an
archive_policy:private(default, API only),public(web pages) oroff. Public pages hide email addresses. - Per-recipient one-click unsubscribe links (RFC 8058) with signed tokens.
- SQLite storage, one YAML config file.
- Admin REST API under
/api/v1(seedocs/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.
Three listeners, each configurable:
| Listener | Default | Purpose |
|---|---|---|
lmtp |
127.0.0.1:2424 |
mail from Postfix |
api |
127.0.0.1:8080 |
admin REST API, bearer token |
web |
127.0.0.1:8081 |
public archive and unsubscribe pages ("" disables) |
Put the web listener behind a reverse proxy with TLS and set base_url to its public URL:
the unsubscribe links in every message use it. Keep the api listener private.
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