[PYTHON] Build the fastest Django development environment with docker-compose

We have released a repository to easily build an environment of "Django + nginx + uwsgi + mysql" using docker-compose.

Public repository

You can easily build it just by git clone and launching the container.

If you want to change the project name, change each configuration file and restart the container.

At the stage of cloning, the initial migration to the DB has been completed.

It was troublesome to write docker-compose.yml every time, so I tried to publish it in the repository because I thought I should publish it.

The basic structure is the following file, so if you want to build it yourself, please refer to it.

(I'm waiting for a comment that there is a better way)

Basically it works by copy and paste, but if you want to change the file name etc., please change it as appropriate.

file organization

(├django files)
(├mysql files)

You don't have to worry about the files in parentheses.

docker-compose.yml First, let's look at the contents

version: '3'

      image: nginx:1.13
        - "8000:8000"
        - ./nginx/conf:/etc/nginx/conf.d
        - ./nginx/uwsgi_params:/etc/nginx/uwsgi_params
        - ./static:/static
        - python

      image: mysql:5.7
      command: mysqld --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci
        - "3306:3306"
        MYSQL_DATABASE: django_docker
        MYSQL_USER: user
        MYSQL_PASSWORD: password
        TZ: 'Asia/Tokyo'
        - ./mysql:/var/lib/mysql
        - ./mysql/sql:/docker-entrypoint-initdb.d

      build: ./python
      command: uwsgi --socket :8001 --module django_docker.wsgi --py-autoreload 1 --logto /tmp/mylog.log
        - ./django:/code
        - ./static:/static
        - "8001"
        - db

Build Websever, DB, and application in separate containers.


In the "nginx" folder, prepare the uwsgi parameter file "uwsgi_params" and the nginx config file "conf/app_nginx.conf".


uwsgi_param  QUERY_STRING       $query_string;
uwsgi_param  REQUEST_METHOD     $request_method;
uwsgi_param  CONTENT_TYPE       $content_type;
uwsgi_param  CONTENT_LENGTH     $content_length;

uwsgi_param  REQUEST_URI        $request_uri;
uwsgi_param  PATH_INFO          $document_uri;
uwsgi_param  DOCUMENT_ROOT      $document_root;
uwsgi_param  SERVER_PROTOCOL    $server_protocol;
uwsgi_param  REQUEST_SCHEME     $scheme;
uwsgi_param  HTTPS              $https if_not_empty;

uwsgi_param  REMOTE_ADDR        $remote_addr;
uwsgi_param  REMOTE_PORT        $remote_port;
uwsgi_param  SERVER_PORT        $server_port;
uwsgi_param  SERVER_NAME        $server_name;


upstream django {
    server python:8001;

server {
    listen      8000;
    charset     utf-8;

    location /static {
        alias /static;

    location / {
        uwsgi_pass  django;
        include     /etc/nginx/uwsgi_params;

server_tokens off;

mysql In the "mysql" folder, only the SQL that gives permissions to the DB user is run first.


GRANT ALL PRIVILEGES ON django_docker.* TO 'user'@'%';


It doesn't matter if you don't understand the meaning of SQL, but if you are interested, please try google.

python In the "python" folder, write a script to run when building a python container and a script to install the necessary python library.

Dockerfile You can change the python version to your liking.

Is it 3.9 if it is the latest? (I'm sorry if I made a mistake)

FROM python:3.6
RUN mkdir /code
ADD requirements.txt /code/
RUN pip install -r requirements.txt
ADD . /code/

requirements.txt Describe the library you want to install in the python container.

There is no problem even if you do not specify the version of the library, but it is also a good point of Docker that you can specify the version of each library in the development environment, so I think that you should specify it.


When the file is ready

Let's start the container when the file is ready

docker-compose up

I think this will launch the container itself, but since there is no django project yet, let's create one.

docker-compose exec python django-admin startproject project name

Let's also migrate including checking if django and DB are communicating

docker-compose exec python python manage.py migrate

at the end

Please note that there are many parts that are not fully explained because it has been scribbled.

It's annoying because the web application framework does the same work first.

I think that it is easier to build a development environment that suits you by automating the parts that can be automated!

I hope it helps someone even a little.

Recommended Posts

Build the fastest Django development environment with docker-compose
Build a Django development environment with Docker! (Docker-compose / Django / postgreSQL / nginx)
[DynamoDB] [Docker] Build a development environment for DynamoDB and Django with docker-compose
Build Django + NGINX + PostgreSQL development environment with Docker
[Python] Build a Django development environment with Docker
Build a Django development environment with Doker Toolbox
Build a development environment with Poetry Django Docker Pycharm
Prepare the development environment with anyenv
[Memo] Build a development environment for Django + Nuxt.js with Docker
[Django] Build a Django container (Docker) development environment quickly with PyCharm
Easily build a development environment with Laragon
Build a Fast API environment with docker-compose
Django development environment construction with Docker-compose + Nginx + uWSGI + MariaDB (macOS edition)
I made a development environment for Django 3.0 with Docker, Docker-compose, Poetry
Build a C language development environment with a container
Build Python development environment with Visual Studio Code
Go (Echo) Go Modules × Build development environment with Docker
Build a Django environment with Vagrant in 5 minutes
Python environment with docker-compose
Quickly build a Python Django environment with IntelliJ
[Memo] Django development environment
Build a Django development environment using pyenv-virtualenv on Mac
Build a machine learning application development environment with Python
Install Ubuntu 20.04 with GUI and prepare the development environment
Remote debug Django environment created with docker-compose with VS Code
Create a django environment with docker-compose (MariaDB + Nginx + uWSGI)
Build a Django environment for Win10 (with virtual space)
Minimal website environment with django
Django development environment construction memo
Build python3 environment with ubuntu 16.04
Build python environment with direnv
Django environment development on Windows 10
[ev3dev × Python] Build ev3dev development environment
django project development environment construction
Unify the environment of the Python development team starting with Poetry
Django + MongoDB development environment maintenance (in the middle of writing)
Build a Go development environment with VS Code's Remote Containers
Build a comfortable development environment with VSCode x Remote Development x Pipenv
How to build a python2.7 series development environment with Vagrant
Create a Todo app with Django ① Build an environment with Docker
How to get into the python development environment with Vagrant
Test Driven Development with Django Part 3
Build FastAPI + uvicorn + nginx with docker-compose
Test Driven Development with Django Part 6
Build python virtual environment with virtualenv
Build Mysql + Python environment with docker
[For beginners] Django -Development environment construction-
Test Driven Development with Django Part 2
Build Flask environment with Dockerfile + docker-compose.yml
Build PyPy execution environment with Docker
Build a web application with Django
Build IPython Notebook environment with boot2docker
Checking the NAOqi Python development environment
Prepare Python development environment with Atom
Test Driven Development with Django Part 1
Rebuild Django's development environment with Docker! !! !! !!
Test Driven Development with Django Part 5
Django cannot be installed in the development environment of pipenv + pyenv
Create a development environment for Go + MySQL + nginx with Docker (docker-compose)
Until you build the environment with ABCI and run MaskTrack RCNN
Learning history to participate in team application development with Python ~ Build Docker / Django / Nginx / MariaDB environment ~