PublicInbox::WWW(3)   User Contributed Perl Documentation  PublicInbox::WWW(3)


NAME
       PublicInbox::WWW - PSGI interface for public-inbox

SYNOPSIS
       In your .psgi file:

               use PublicInbox::WWW;

               my $www = PublicInbox::WWW->new;
               builder {
                       enable 'Head';
                       mount '/inboxes' => sub { $www->call(@_) };
               };

DESCRIPTION
       The PSGI web interface for public-inbox.

       Using this directly is not needed unless you wish to customize your
       public-inbox PSGI deployment or are using a PSGI server other than
       public-inbox-netd(1) ("-netd") / public-inbox-httpd(1) ("-httpd")

       While this PSGI application should work with all PSGI/Plack web servers
       such as starman(1), starlet(1) or twiggy(1); PublicInbox::WWW takes
       advantage of internal APIs of "-netd" and "-httpd" to improve fairness
       when serving large responses for thread views, mbox downloads, and git
       clones.

ENVIRONMENT
       PI_CONFIG
               Used to override the default "~/.public-inbox/config" value.

CONTACT
       Feedback welcome via plain-text mail to <mailto:meta@public-inbox.org>

       The mail archives are hosted at <https://public-inbox.org/meta/> and
       <http://4uok3hntl7oi7b4uf4rtfwefqeexfzil2w6kgk2jn5z2f764irre7byd.onion/meta/>

COPYRIGHT
       Copyright (C) all contributors <mailto:meta@public-inbox.org>

       License: AGPL-3.0+ <http://www.gnu.org/licenses/agpl-3.0.txt>

SEE ALSO
       <http://plackperl.org/>, Plack, public-inbox-netd(1),
       public-inbox-httpd(1)

perl v5.42.2                      2026-04-30               PublicInbox::WWW(3)