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   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 ENVIRONMENT
  24
  25 =over 8
  26
  27 =item GIT_HTTP_MAX_REQUEST_BUFFER
  28
  29 Shared with L<git-http-backend(1)>, this governs the maximum upload
  30 size of an HTTP request.
  31
  32 Default: 10m
  33
  34 =back
  35
  36 =head1 CONTACT
  37
  38 Feedback welcome via plain-text mail to L<mailto:meta@public-inbox.org>
  39
  40 The mail archives are hosted at L<https://public-inbox.org/meta/> and
  41 L<http://4uok3hntl7oi7b4uf4rtfwefqeexfzil2w6kgk2jn5z2f764irre7byd.onion/meta/>
  42
  43 =head1 COPYRIGHT
  44
  45 Copyright all contributors L<mailto:meta@public-inbox.org>
  46
  47 License: AGPL-3.0+ L<https://www.gnu.org/licenses/agpl-3.0.txt>
  48
  49 =head1 SEE ALSO
  50
  51 L<git(1)>, L<git-config(1)>, L<public-inbox-daemon(8)>,
  52 L<Plack>