aboutsummaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorRunxi Yu <me@runxiyu.org>2025-04-01 13:51:25 +0800
committerRunxi Yu <me@runxiyu.org>2025-04-01 13:54:48 +0800
commita5b72b25a298040798636455d29a7413636368f2 (patch)
treec0678b13a6a5bf523a2d191eb2e3e5fdd9a7d9b1 /man
parentLMTP configuration update (diff)
downloadforge-a5b72b25a298040798636455d29a7413636368f2.tar.gz
forge-a5b72b25a298040798636455d29a7413636368f2.tar.zst
forge-a5b72b25a298040798636455d29a7413636368f2.zip
Add forge-mail(5) and update forge(5) for LMTP
Diffstat (limited to 'man')
-rw-r--r--man/forge-mail.531
-rw-r--r--man/forge.514
2 files changed, 45 insertions, 0 deletions
diff --git a/man/forge-mail.5 b/man/forge-mail.5
new file mode 100644
index 0000000..58e3580
--- /dev/null
+++ b/man/forge-mail.5
@@ -0,0 +1,31 @@
+.\" SPDX-License-Identifier: AGPL-3.0-only
+.\" SPDX-FileCopyrightText: Copyright (c) 2025 Runxi Yu <https://runxiyu.org>
+.Dd March 30, 2025
+.Dt FORGE-MAIL 5
+.Os Lindenii Forge
+.Sh NAME
+.Nm forge-mail
+.Nd configuring Lindenii Forge email integration
+.Sh DESCRIPTION
+.Nm
+is a guide to configuring Lindenii Forge for email integration.
+.Pp
+This is currently a stub. Here is a working configuration that works
+for the Lindenii Project itself, though.
+.Sh /etc/smtpd/smtpd.conf
+.Bd -literal
+table forge file:/etc/smtpd/forge
+action "FORGE" lmtp "/srv/forge/lmtp.sock" rcpt-to virtual <forge>
+match from any for domain "forge.lindenii.runxiyu.org" action "FORGE"
+.Ed
+.Sh /etc/smtpd/forge
+.Bd -literal
+@ forge
+.Ed
+.Sh SEE ALSO
+.Xr forge 1 ,
+.Xr forge 5 ,
+.Xr smtpd.conf 5
+.Sh AUTHORS
+.An Runxi Yu Aq Mt https://runxiyu.org
+.An Test_User Aq Mt hax@runxiyu.org
diff --git a/man/forge.5 b/man/forge.5
index c8eed43..177c7f4 100644
--- a/man/forge.5
+++ b/man/forge.5
@@ -104,6 +104,20 @@ Maximum send queue size.
.It Ic nick , user , gecos
Identity fields for the IRC connection.
.El
+.It Ic lmtp
+Configuration for the LMTP/MX component. You may wish to refer to
+.Xr forge-mail 5
+for information on configuring your SMTP server.
+.Bl -tag -width Ds
+.It Ic socket
+The path to the UNIX domain socket to listen on.
+.It Ic max_size
+The maximum acceptable ingress message size.
+.It Ic domain
+The domain-part of our LMTP server.
+.It Ic read_timeout , write_timeout
+General timeouts for LMTP connections.
+.El
.El
.Sh FILES
.Bl -tag -width Ds