]> Sergey Matveev's repositories - public-inbox.git/blob - Documentation/public-inbox-httpd.pod
searchidx: use singular `$opt' for consistency with v2
[public-inbox.git] / Documentation / public-inbox-httpd.pod
1 =head1 NAME
2
3 public-inbox-httpd - PSGI server optimized for public-inbox
4
5 =head1 SYNOPSIS
6
7 B<public-inbox-httpd> [OPTIONS] [/path/to/myapp.psgi]
8
9 =head1 DESCRIPTION
10
11 public-inbox-httpd is a PSGI/Plack server supporting HTTP/1.1
12 and HTTP/1.0.  It uses options and environment variables common
13 to all L<public-inbox-daemon(8)> implementations in addition to
14 the PSGI file.
15
16 If a PSGI file is not specified, L<PublicInbox::WWW> is
17 loaded with a default middleware stack consisting of
18 L<Plack::Middleware::ReverseProxy>, and
19 L<Plack::Middleware::Head>
20
21 This may point to a PSGI file for supporting generic PSGI apps.
22
23 =head1 CONTACT
24
25 Feedback welcome via plain-text mail to L<mailto:meta@public-inbox.org>
26
27 The mail archives are hosted at L<https://public-inbox.org/meta/>
28 and L<http://hjrcffqmbrq6wope.onion/meta/>
29
30 =head1 COPYRIGHT
31
32 Copyright 2013-2020 all contributors L<mailto:meta@public-inbox.org>
33
34 License: AGPL-3.0+ L<https://www.gnu.org/licenses/agpl-3.0.txt>
35
36 =head1 SEE ALSO
37
38 L<git(1)>, L<git-config(1)>, L<public-inbox-daemon(8)>,
39 L<Plack>