NAME
Plack::Handler::Hyperman - Plack/PSGI adapter for the Hyperman server
SYNOPSIS
plackup -s Hyperman --port 8080 --workers 6 app.psgiDESCRIPTION
Lets any Plack application run on Hyperman, the kqueue event-loop PSGI server. Options: host, port, and workers (alias max_workers), plus listen for binding several listeners (for example plain :80 beside TLS :443) in one server - see "Multiple listeners" in Hyperman.
Every other Hyperman->run option is passed through when given and left alone when not, so a server started by plackup behaves identically to the same options passed to run directly: reuseport, max_requests_per_worker, shutdown_grace, affinity, idle_timeout, header_timeout, max_pipeline, http2, redirect_https, max_body, access_log, deny, deny_capacity, rate_capacity, bus_slots, bus_slot_size, bus_groups, compress, compress_min_length, compress_level, and the tls_* family. See "run" in Hyperman for what each means; the two that most often want setting have their own sections below.
deny takes an arrayref, and a single --deny 1.2.3.4 on a command line arrives as a plain scalar, so one address is accepted as readily as several.
max_body
The largest request Hyperman will buffer, headers plus body, before the application is called. Over it, the request is answered 413 Payload Too Large. The default is 16MB.
plackup -s Hyperman --max_body 67108864 # 64MB, for large uploads
plackup -s Hyperman --max_body 262144 # 256KB, for a JSON APICompression
Response compression is off by default, as it is under Hyperman->run, and is turned on per server:
plackup -s Hyperman --compress 1
plackup -s Hyperman --compress 1 --compress_min_length 512
plackup -s Hyperman --compress 1 --compress_level 6A response is compressed only if the client accepted gzip, it carries no Content-Encoding of its own, its media type is on the compressible allowlist, and it is at least compress_min_length bytes. On a Hyperman built without zlib the option is accepted and inert. See "Response compression" in Hyperman for the full contract, including the Content-Encoding: identity opt-out and the ETag rewrite.
SEE ALSO
AUTHOR
LNATION <email@lnation.org>
LICENSE AND COPYRIGHT
This software is Copyright (c) 2026 by LNATION. This is free software, licensed under the Artistic License 2.0.