This document covers the installation steps for lists.sr.ht, a SourceHut service for hosting mailing lists.
Familiarize yourself with the general installation documentation before getting started.
The following daemons are provided by the lists.sr.ht package:
lists.sr.ht — The web service.lists.sr.ht-api — The API service.lists.sr.ht-ingress — Incoming mail service.It is not necessary for any/all of these to run on the same server. You may prefer to run lists.sr.ht-ingress on your mail server, for example.
A production-ready mail server which supports both incoming and outgoing email
is a requirement for running lists.sr.ht. The configuration of your mail system
is out of scope for this documentation. We use Postfix for SourceHut
production, but any mail server will suffice provided that it supports SMTP for
outgoing mail and SMTP or LMTP for forwarding mail to lists.sr.ht-ingress.
Consult the [lists.sr.ht::worker] section of config.ini to configure the
ingress daemon to process emails from your mail server. Outgoing email for
forwarding emails to mailing list subscribers is configured using the same
[mail] section as other services use.
commit b45bd9486314bb2975c8d36272962f57a8d0da90 Author: Gary Kim <gary@garykim.dev> Date: 2026-08-01T16:19:47-04:00 builds.sr.ht: remove EOL Fedora 42 image