Python UWSGI

uWSGI is a Protocols/UWSGI server. Although it is written in C, it's more commonly used by Python projects.

Contents

  1. Python UWSGI
    1. Installation
      1. Alpine Linux
    2. Configuration
      1. Unix Sockets

Installation

Most Linux operating systems offer both the server and the Python plugin as a package. Try installing uswgi and uwsgi-python3, or uwsgi-python for the Python 2 version.

Alpine Linux

If using Python 2, note that Alpine Linux has dropped support for the corresponding software. The last version to offer a uwsgi-python package is 3.10.

For Dockerfiles, consider the below a template: 

FROM alpine:3.10
RUN apk add python uwsgi uwsgi-python

RUN addgroup -S -g 82 www-data && adduser -S -u 82 -D -h /var/www -s /sbin/nologin www-data
COPY --chown=www-data:www-data local/path/to/app /app
WORKDIR /app

EXPOSE 9000
ENTRYPOINT ["/usr/sbin/uwsgi"]
CMD ["--ini", "/app/uwsgi.ini"]

Configuration

uWSGI requires a configuration file to run, typically named uwsgi.ini. A basic one looks like: 

[uwsgi]
uid = www-data
gid = www-data
socket = :9000
plugin = python

chdir = /app/example.com
wsgi-file = /app/example.com/example.wsgi

master
workers = 3
max-requests = 200
harakiri = 60
die-on-term

The wsgi-file is the Python program that will be served.

Unix Sockets

If exposing the server over a Unix socket instead of a port, try: 

socket = /app/example.com/example.sock
chmod-socket = 660

CategoryRicottone