aiohttp-wsgi-serve(1)

NAME

aiohttp-wsgi-serve - run a WSGI application

SYNOPSIS

aiohttp-wsgi-serve [-h] [--host HOST] [--port PORT]
                   [--unix-socket UNIX_SOCKET]
                   [--unix-socket-perms UNIX_SOCKET_PERMS]
                   [--backlog BACKLOG] [--static STATIC]
                   [--static-cors STATIC_CORS]
                   [--script-name SCRIPT_NAME]
                   [--url-scheme URL_SCHEME] [--threads THREADS]
                   [--inbuf-overflow INBUF_OVERFLOW]
                   [--max-request-body-size MAX_REQUEST_BODY_SIZE]
                   [--shutdown-timeout SHUTDOWN_TIMEOUT] [--verbose]
                   [--quiet] [--version]
                   module:application

DESCRIPTION

Run a WSGI application on top of asyncio event loop.

OPTIONS

-h, --help

show help message and exit

--host HOST

Host interfaces to bind. Defaults to '0.0.0.0' and '::'. Can be specified multiple times.

--port PORT, -p PORT

Port to bind. Defaults to 8080.

--unix-socket UNIX_SOCKET

Path to a unix socket to bind, cannot be used with host.

--unix-socket-perms UNIX_SOCKET_PERMS

Filesystem permissions to apply to the unix socket. Defaults to 384.

--backlog BACKLOG

Socket connection backlog. Defaults to 1024.

--static STATIC

Static route mappings in the form 'path=directory'. `path` must start with a slash, but not end with a slash. Can be specified multiple times.

--static-cors STATIC_CORS

Set to '*' to enable CORS on static files for all origins, or a string to enable CORS for a specific origin. Defaults to None.

--script-name SCRIPT_NAME

URL prefix for the WSGI application, should start with a slash, but not end with a slash. Defaults to ''.

--url-scheme URL_SCHEME

A hint about the URL scheme used to access the application. Corresponds to environ['wsgi.url_scheme']. Default is auto-detected to 'http' or 'https'.

--threads THREADS

Number of threads used to process application logic. Defaults to 4.

--inbuf-overflow INBUF_OVERFLOW

A tempfile will be created if the request body is larger than this value, which is measured in bytes. Defaults to 524288.

--max-request-body-size MAX_REQUEST_BODY_SIZE

Maximum number of bytes in request body. Defaults to 1073741824. Larger requests will receive a HTTP 413 (Request Entity Too Large) response.

--shutdown-timeout SHUTDOWN_TIMEOUT

Timeout when closing client connections on server shutdown. Defaults to 60.0.

--verbose, -v

Increase verbosity. Can be specified multiple times.

--quiet, -q

Decrease verbosity. Can be specified multiple times.

--version

Display version information.

EXAMPLES

Run WSGI application on local port 8000 with 8 threads:

     $ aiohttp-wsgi-serve --host 127.0.0.1 --port 8000 --threads 8 wsgiapp:main

AUTHOR

aiohttp-wsgi was written by David Hall <[email protected]>.

This manual page was written by William Grzybowski <[email protected]> for the Debian project (but may be used by others).