Table of Contents

  1. Installation

This document covers the installation steps for lists.sr.ht, a SourceHut service for hosting mailing lists.

Installation

Familiarize yourself with the general installation documentation before getting started.

Daemons

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.

Mail server

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.

About this wiki

commit 8d6d72442c116c48f9bdeaf11429f906c1e0f993
Author: CismonX <admin@cismon.net>
Date:   2026-05-12T11:45:59+08:00

Fix typos

Noticed a typo while reading the docs, so I ran crate-ci/typos
on the entire repo, and fixed them once and for all :)

Notes:
- "publically" is not necessarily a typo, but it is considered
  non-standard in modern English. Use "publicly" instead.
- Similar case with "moreso".
Clone this wiki ("master" branch)
https://git.sr.ht/~sircmpwn/sr.ht-docs (read-only)
git@git.sr.ht:~sircmpwn/sr.ht-docs (read/write)