Skip to main content

A Kubernetes Native Stack Specifically Created For Django

Project description

PyPI version Build Status Quality Gate Status Coverage Status ReadTheDocs License: MIT Code style: black

Hurricane Logo


An initiative to fit Django perfectly with Kubernetes. It is supposed to cover many capabilities in order to run Django in a cloud-native environment, including a Tornado-powered Django app server.
Explore the docs »

Hurricane website · User's guide · Guide to the first Hurricane-based Application


Django was developed with the batteries included-approach and already handles most of the challenges around web development with grace. It was initially developed at a time when web applications got deployed and run on a server (physical or virtual). With its pragmatic design it enabled many developers to keep up with changing requirements, performance and maintenance work.
However, service architectures have become quite popular for complex applications in the past few years. They provide a modular style based on the philosophy of dividing overwhelming software projects into smaller and more controllable parts. The advantage of highly specialized applications gained prominence among developers, but introduces new challenges to the IT-operation.
However, with the advent of Kubernetes and the cloud-native development philosophy a couple of new possibilities emerged to run those service-based applications even better. Kubernetes is a wonderful answer for just as many IT-operation requirements as Django is for web development. The inherent monolithic design of Django can be tempting to roll out recurring operation patterns with each application. It's not about getting Django to run in a Kubernetes cluster (you may already solved this), it's about integrating Django as tightly as possible with Kubernetes in order to harness the full power of that platform. Creating the most robust, scalable and secure applications with Django by leveraging the existing expertise of our favorite framework is the main goal of this initiative.

Hurricane is supposed to make the most out of the existing Django ecosystem without reinventing the wheel. We will collect best-practices and opinions about how to run Django in Kubernetes and put them on Hurricane's roadmap.

Application Server

Why another app server instead of uwsgi, gunicorn or mod_wsgi? We need a cloud-native app server which is much more tidily coupled to the Django application itself. Think of special URL routes for Kubernetes probes! Building a special View in each and every Django application is not an appropriate solution. What about the Kubernetes Metrics API? That's all something we don't want to take care of in our Django code.
Those traditional app servers (i.e. uwsgi have a highly optimized process model for bare-server deployments with many CPUs, multiple threads and so on. In Kubernetes the scaling of an application is done through the Replication-value in a workload description manifest. This is no longer something we configure with app server parameters.


Hurricane can be installed from a Python Package Index:

pip3 install django-hurricane

Add "hurricane" to your INSTALLED_APPS:


You can start the Hurricane server with a following command:

python serve --autoreload --static

The ouput of this command looks as following:

System check identified some issues:

2022-05-04 02:19:07,521 INFO     hurricane.server.general Tornado-powered Django web server
2022-05-04 02:19:07,521 INFO     hurricane.server.general Starting probe application running on port 8001 with route liveness-probe: /alive, readiness-probe: /ready, startup-probe: /startup
2022-05-04 02:19:07,523 INFO     hurricane.server.general Starting HTTP Server on port 8000
2022-05-04 02:19:07,524 INFO     hurricane.server.general Startup time is 0.0026285648345947266 seconds

There are many options that can be used in a combination with the serve command. Please refer to the documentation to learn more about the options.

Django-hurricane works best in combination with Kubernetes, as it includes the inbuilt health-probes, i.e. liveness, readiness and startup probes. Additionally, it is possible to implement custom checks. These checks will be executed after the standard django checks. Follow our guide to learn how to write a custom check.

Commercial Support

Hurricane is developed and maintained by Blueshoe. If you need any help implementing with hurricane or you want to tell us about the use-case, how you use hurricane, please contact us:

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django_hurricane-1.5.0.tar.gz (30.9 kB view hashes)

Uploaded source

Built Distribution

django_hurricane-1.5.0-py3-none-any.whl (37.9 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page