• latest, 2.0-python3
• 2.0-python3-onbuild
• 1.11-python3
• 1.11-python3-onbuild
• 1.11-python2
• 1.11-python2-onbuild

This image can be used as a starting point to run django applications.

It uses gunicorn in the latest version to serve the wsgi application. The container picks up the wsgi entry point based on the environment variable DJANGO_APP. Gunicorn uses the port defined by the environment variable PORT (default port is 8000). The environment variable GUNICORN_RELOAD can be set to true to active live reload if a source file does change.

Django is already installed within the version specified by the image. For example 2.0-python3 will contain the latest django version of 2.0.x. The image does also ship with the latest version of pytz and gettext installed. Using the latest supported python version for the corresponding django release.

It has a volume defined to generate static resources at /var/www/static. The volume /usr/django/app can be used for live reload during development.

To execute django management commands like for example collectstatic the environment variable DJANGO_MANAGEMENT_ON_START can be set to a semicolon separated list of commands (e.g. migrate --noinput;collectstatic --noinput). These commands will be executed in the specified order before django will be started. This docker image can also be used to execute certain management commands without starting django afterwards. This is useful if you are running multiple django containers and want to schedule a job only once. Therefore use the environment variable DJANGO_MANAGEMENT_JOB.

The environment variables DJANGO_MIGRATE, DJANGO_COLLECTSTATIC and DJANGO_COMPRESS are deprecated, please migrate to DJANGO_MANAGEMENT_ON_START.

FROM alang/django
ENV DJANGO_APP=demo                # will start /usr/django/app/demo/wsgi.py
COPY src /usr/django/app

The -onbuild variant of the image does assume that your build directory (directory where the Dockerfile is located) contains a directory called src which is the place where the django source code is. This directory will be copied to /usr/django/app. The image does also assume that your source code contains a requirements.txt file in the src directory. All dependencies listed there will be installed.

Bootstrap a new project called demo within the src folder:

docker run --rm -v "$PWD/src:/usr/django/app" alang/django django-admin startproject demo app

How to execute one off django commands like makemigrations:

docker run --rm -v "$PWD/src:/usr/django/app" -e DJANGO_MANAGEMENT_JOB=makemigrations alang/django

A custom gunicorn config can be included:

COPY gunicorn.conf /etc/gunicorn/

If you have any problems with or questions about this image, please contact me through a GitHub issue.

You are invited to contribute new features, fixes, or updates, large or small. Please send me a pull request.