gunicorn-torify 19.12.1

Turn any Gunicorn application into a Tor Onion Service

Gunicorn Torify

Turn any Gunicorn server into a Tor Onion Service

Installation

It's available on PyPI! Just use pip to install

$ pip install gunicorn-torify

You must have Tor installed to use gunicorn-torify. This would might look like

# Arch
$ pacman -S tor
# Debian/Ubuntu
$ apt install tor
# Alpine
$ apk add tor

Usage

If you don't use a Gunicorn config file, then create some python file such as ./gunicorn-conf.py with the line

from gunicorn_torify import on_starting, on_exit

Then when starting Gunicorn, be sure to include the --config ./gunicorn-conf.py flag.

Contributing

To setup the development environment, it's convenient to use pyenv and the pyenv virtualenv plugin. For example

$ pyenv virtualenv 3.8.1 gunicorn-torify-3.8
$ pyenv activate gunicorn-torify-3.8
$ pip install -r requirements_dev.txt

TODO

• Example with FastAPI & uvicorn worker for Gunicorn
• Load balancing support?
• Docs about persistence of the secrets directory
• Proper tests