Documentation

xListman is a mailing list manager, not a hosted service — running it means a few deliberate steps: install the binary, configure it, and point your mail server at it. These guides walk through each one, in the order you’ll need them.

If you’re new to mailing lists entirely, start with How it works — it explains the model in plain language before any installation.

Getting started

• How it works — what a list, a subscriber, and a subscription actually are, in plain language.
• Install — run xListman with Docker, a release binary, or a build from source.
• First steps — create a domain, a list, and your first owner, then send a post.

Setup

• Configuration — config.yaml, environment variables, and secret expansion.
• MTA integration — wire Postfix, exim, or a pipe socket to deliver the list domain.
• Postfix — the Postfix configuration, step by step.
• exim — the exim configuration, step by step.
• Pipe mode — when you’d rather not run LMTP.

Operating

• The web UI — login, self-service, and the role consoles.
• Archives — threaded, searchable, members-only history.
• Moderation — held messages, approve / reject / discard.
• Command line — the xlistman CLI for administration.

Subscribers

• Email commands — the -request command surface.
• Subscriptions & self-service — digest, nomail, re-enable, unsubscribe.

Help

• Troubleshooting & FAQ — the things that go wrong, and how to fix them.