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 0b2cece8723735483503b97574b18741d0710998 Author: fardog <nat@fardog.io> Date: 2026-01-07T20:47:09Z terms: fix language around content deletion This supersedes [#66048][], as I named the incorrect project name in the subject, which caused the build to fail. Original email is quoted below: [#66048]: https://lists.sr.ht/~sircmpwn/sr.ht-dev/patches/66048 A very small typo I noted in the terms of service; alternatively it could be corrected as "will not [be] displayed", but either one reads fine to me. No worries if the terms need more ceremony to be changed; was as easy to submit as a patch as it would've been to raise in the mailing list.