Gunicorn can’t find app when name changed from “application”

Gunicorn (and most WSGI servers) defaults to looking for the callable named application in whatever module you point it at. Adding an alias from myproject import myapp as application or application = myapp will let Gunicorn discover the callable again.

However, the wsgi.py file or the alias aren’t needed, Gunicorn can be pointed directly at the real module and callable.

gunicorn myproject:myapp --workers 16
# equivalent to "from myproject import myapp as application"

Gunicorn can also call an app factory, optionally with arguments, to get the application object. (This briefly did not work in Gunicorn 20, but was added back in 20.0.1.)

gunicorn 'myproject.app:create_app("production")' --workers 16
# equivalent to:
# from myproject.app import create_app
# application = create_app("production")

For WSGI servers that don’t support calling a factory, or for other more complicated imports, a wsgi.py file is needed to do the setup.

from myproject.app import create_app
app = create_app("production")
gunicorn wsgi:app --workers 16

Leave a Comment