public-inbox-netd(1)

1PUBLIC-INBOX-NETD(1)       public-inbox user manual       PUBLIC-INBOX-NETD(1)
2
3
4

NAME

6       public-inbox-netd - read-only network daemon for sharing public-inboxes
7

SYNOPSIS

9         public-inbox-netd [OPTIONS]
10

DESCRIPTION

12       public-inbox-netd provides a read-only multi-protocol
13       (HTTP/IMAP/NNTP/POP3) daemon for public-inbox.  It uses options and
14       environment variables common to all public-inbox-daemon(8)
15       implementations.
16
17       The default configuration will never require write access to the
18       directory where the public-inbox is stored, so it may be run as a
19       different user than the user running public-inbox-watch(1),
20       public-inbox-mda(1), or git-fetch(1).
21

OPTIONS

23       See common options in "OPTIONS" in public-inbox-daemon(8).
24
25       -l PROTOCOL://ADDRESS/?cert=/path/to/cert,key=/path/to/key
26       --listen PROTOCOL://ADDRESS/?cert=/path/to/cert,key=/path/to/key
27       -l http://ADDRESS/?env.PI_CONFIG=/path/to/cfg,psgi=/path/to/app.psgi
28           In addition to the normal "-l"/"--listen" switch described in
29           public-inbox-daemon(8), the protocol prefix (e.g. "nntp://" or
30           "nntps://") may be specified to force a given protocol.
31
32           Environment variable overrides in effect during loading and
33           reloading (SIGHUP) can be specified as "env.NAME=VALUE" for all
34           protocols.
35
36           HTTP(S) listeners may also specify "psgi=" to use a different
37           ".psgi" file for each listener.
38
39           "err=/path/to/errors.log" may be used to isolate error/debug output
40           for a particular listener away from "--stderr".
41
42           Non-HTTP(S) listeners may also specify "out=" for logging to
43           "stdout".  HTTP(S) users are encouraged to configure
44           Plack::Middleware::AccessLog or
45           Plack::Middleware::AccessLog::Timed, instead.
46
47       --cert /path/to/cert
48           See public-inbox-daemon(1).
49
50       --key /path/to/key
51           See public-inbox-daemon(1).
52

CONFIGURATION

54       These configuration knobs should be used in the public-inbox-config(5).
55
56       publicinbox.<name>.newsgroup
57       publicinbox.nntpserver
58       publicinbox.pop3state
59
60       See public-inbox-config(5) for documentation on them.
61

CONTACT

63       Feedback welcome via plain-text mail to <mailto:meta@public-inbox.org>
64
65       The mail archives are hosted at <https://public-inbox.org/meta/>, and
66       <nntp://news.public-inbox.org/inbox.comp.mail.public-inbox.meta>,
67       <nntp://4uok3hntl7oi7b4uf4rtfwefqeexfzil2w6kgk2jn5z2f764irre7byd.onion/inbox.comp.mail.public-inbox.meta>
68

COPYRIGHT

70       Copyright all contributors <mailto:meta@public-inbox.org>
71
72       License: AGPL-3.0+ <https://www.gnu.org/licenses/agpl-3.0.txt>
73