uwsgi

Run a WSGI application with HTTP server

$ uwsgi --http :8080 --wsgi-file [app.py]

$ uwsgi --http :8080 --wsgi-file [app.py] --master --processes [4] --threads [2]

$ uwsgi --socket [/tmp/uwsgi.sock] --wsgi-file [app.py] --chmod-socket=666

$ uwsgi --http :8080 --module [myproject.wsgi]:application

$ uwsgi --ini [uwsgi.ini]

$ uwsgi --http :8080 --wsgi-file [app.py] --stats 127.0.0.1:9191

uwsgi [options]

uWSGI is an application server that implements the WSGI specification for serving Python web applications. It provides a bridge between web servers like Nginx and Python frameworks like Django, Flask, and Pyramid.
The server supports multiple protocols: HTTP for direct serving, the uwsgi binary protocol for efficient Nginx communication, and sockets for local IPC. It handles process management, load balancing, and caching.
Configuration can be provided via command-line options or INI/YAML/JSON files. The master process mode enables graceful reloading and automatic worker respawning.

--http address

Enable HTTP server on specified address:port

Bind to specified UNIX/TCP socket for uwsgi protocol

Load WSGI application from Python file

Load WSGI application from specified module

Enable master process for managing workers

Spawn n worker processes

Run n threads per worker process

Change to directory before loading application

Use specified Python virtualenv

Load configuration from INI file

Enable stats server on specified address

Set socket file permissions

uWSGI has been in maintenance mode since October 2022. Consider alternatives like Gunicorn for new projects. The uwsgi protocol (lowercase) is different from the uWSGI application server. Socket permissions require careful configuration when running behind Nginx.

uWSGI was developed as a full-stack application server supporting multiple languages and protocols. Despite its name coming from WSGI, it expanded to support Ruby (Rack), Perl (PSGI), and other languages. The project became widely adopted for Python deployments.

gunicorn(1), nginx(8), python(1), pip(1)