aiohttp-wsgi-serve(1)

aiohttp-wsgi-serve1

Run a wsgi application

Usage

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

Overview

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

Releases

Unchanged in 3 releases since Debian 11 (Bullseye).

  1. 11–13

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).

From aiohttp-wsgi-serve 0.10.0-1 in Debian 13 (Trixie). Parsed by carta from the page's man source.