Custom ApplicationΒΆ

New in version 19.0.

Sometimes, you want to integrate Gunicorn with your WSGI application. In this case, you can inherit from

Here is a small example where we create a very small WSGI app and load it with a custom Application:

from __future__ import unicode_literals

import multiprocessing


from gunicorn.six import iteritems

def number_of_workers():
    return (multiprocessing.cpu_count() * 2) + 1

def handler_app(environ, start_response):
    response_body = b'Works fine'
    status = '200 OK'

    response_headers = [
        ('Content-Type', 'text/plain'),

    start_response(status, response_headers)

    return [response_body]

class StandaloneApplication(

    def __init__(self, app, options=None):
        self.options = options or {}
        self.application = app
        super(StandaloneApplication, self).__init__()

    def load_config(self):
        config = dict([(key, value) for key, value in iteritems(self.options)
                       if key in self.cfg.settings and value is not None])
        for key, value in iteritems(config):
            self.cfg.set(key.lower(), value)

    def load(self):
        return self.application

if __name__ == '__main__':
    options = {
        'bind': '%s:%s' % ('', '8080'),
        'workers': number_of_workers(),
    StandaloneApplication(handler_app, options).run()