lists.sr.ht is the mailing list service for lists.sr.ht. There are a number of important components:

LMTP daemon installation

The LMTP daemon is available in the lists.sr.ht package, at the binary lists-srht-lmtp. It needs to run on your mail server, and you need to configure your MTA to forward emails to it.

The LMTP daemon uses the same config file as the others, and there are some options there specifically catered to it. The most important is the Unix socket path for the LMTP socket - and the user/group it should be assigned to. Make sure that this is readable and writable by your MTA.

Enable the lists.sr.ht-lmtp service and configure your MTA to forward emails to the socket.

Mail server setup

The precise configuration of your mail server is a very subjective matter, and we don't have a one-size-fits-all solution to give you. Here's an example of forwarding to lists.sr.ht with postfix:

# main.cf
local_transport = local:$myhostname
transport_maps = hash:/etc/postfix/transport

# /etc/postfix/transport
lists.sr.ht lmtp:unix:/tmp/lists.sr.ht-lmtp.sock
sr.ht local:sr.ht

This forwards mail to @lists.sr.ht to the LMTP socket, and processes mail to @sr.ht to local mailboxes. This is just one part of your setup, however, and the remainder of your postfix (or other mail server) configuration is left as an exercise to the reader.

Celery worker installation

On servers which should process forwarding and archival, install the lists.sr.ht package and enable the lists.sr.ht-worker service. Make sure you review the config file for worker-specific options as well. The Redis instance you use here should be shared with the LMTP daemon and other worker nodes to ensure that messages can be distributed correctly.

Web service installation

The lists.sr.ht web service is a standard sr.ht web service and can be installed through the standard procedure.

Hacking on lists.sr.ht

A minimal local mail server setup which can be used to work on lists.sr.ht is described in this article.

About this wiki

commit 25c36722c582a6c9b2ef13869530ff377b565d98
Author: Drew DeVault <sir@cmpwn.com>
Date:   2019-10-22T20:16:58+00:00

git.sr.ht/installation.md: update for new shell
Clone this wiki
https://git.sr.ht/~sircmpwn/sr.ht-docs (read-only)
git@git.sr.ht:~sircmpwn/sr.ht-docs (read/write)