Hypercorn is invoked via the command line script hypercorn
$ hypercorn [OPTIONS] MODULE_APP
with MODULE_APP has the pattern
$(MODULE_NAME):$(VARIABLE_NAME) with the module name as a full
(dotted) path to a python module containing a named variable that
conforms to the ASGI framework specification.
show this help message and exit
Deprecated, see access-logfile
The target location for the access log, use - for
The log format for the access log, see help docs
The maximum number of pending connections
The TCP host/address to bind to. Should be either
host:port, host, unix:path or fd://num, e.g.
127.0.0.1:5000, 127.0.0.1, unix:/tmp/socket or fd://33
Path to the SSL CA certificate file
Path to the SSL certificate file
See verify mode argument
Ciphers to use for the SSL setup
Location of a TOML config file or when prefixed with
python: a Python file.
Enable debug mode, i.e. extra logging and checks
Deprecated, see error-logfile
The target location for the error log, use - for
Time to wait after SIGTERM or Ctrl-C for any
remaining requests (tasks) to complete.
Group to own any unix sockets.
The type of worker to use. Options include asyncio,
uvloop (pip install hypercorn[uvloop]), and trio (pip
Seconds to keep inactive connections alive for
Path to the SSL key file
The TCP host/address to bind to. SSL options will not
apply to these binds. See bind for formatting
options. Care must be taken! See HTTP -> HTTPS
A Python logging configuration file.
The (error) log level, defaults to info
Location to write the PID (Program ID) to.
The UDP/QUIC host/address to bind to. See bind for
Enable automatic reloads on code changes
The setting for the ASGI root_path variable
The hostnames that can be served, requests to
different hosts will be responded to with
The host:port of the statsd server
Prefix for all statsd messages
The permissions bit mask to use on any unix sockets.
User to own any unix sockets.
SSL verify mode for peer’s certificate, see
ssl.VerifyMode enum for possible values.
If set this is the time in seconds between
pings sent to the client. This can be used to
keep the websocket connection alive.
The number of workers to spawn and use