---
name: "PublicInbox::WWW"
section: "3pm"
platform: "linux"
package: "perl-publicinbox"
version: "2.1.0-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/PublicInbox::WWW"
---

# PublicInbox::WWW(3pm)

PSGI interface for public-inbox

## 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)](/public-inbox-netd/1.md) (`"-netd"`) / [**public-inbox-httpd**(1)](/public-inbox-httpd/1.md) (`"-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-netd/1.md), [**public-inbox-httpd**(1)](/public-inbox-httpd/1.md)