daniel-tomaszuk / docker-django-boilerplate

Minimal boilerplate setup for a Django project with Docker.

Docker Django Boilerplate

Minimal setup for a Django project with Docker, following the 12factor app principles. This repo contains skeleton code to get up and running with Docker & Django quickly. The image uses uWSGI to host the Django project. It's up to you to put Nginx or Apache in front in production.

This image is not intended as being a base image for a Django project. It's a boilerplate, you can copy/paste this and use it as a base to start a project. The image contains the hello Django project. Replace the word hello with the name of your project.

Usage

Download the repository:

$ git clone https://github.com/lukin0110/docker-django-boilerplate.git

Init project:

$ cd docker-django-boilerplate
$ docker-compose build

Setup database:

$ docker-compose up -d postgres
$ docker-compose run app setup_db

Launch:

$ docker-compose up app

Launch Nginx (optional):

$ docker-compose up web

Now your django app is available on http://localhost, but it's optional for development

Container commands

The image has

Run a command:

$ docker-compose run app <command>

Available commands:

Command	Description
dev	Start a normal Django development server
bash	Start a bash shell
manage	Start manage.py
setup_db	Setup the initial database. Configure $POSTGRES_DB_NAME in docker-compose.yml
lint	Run pylint
python	Run a python command
shell	Start a Django Python shell
uwsgi	Run uwsgi server
help	Show this message

Create a Django app

$ docker-compose run app manage startapp myapp

Create a super user

$ docker-compose run app manage createsuperuser

Awesome resources

Useful awesome list to learn more about all the different components used in this repository.

• Docker
• Django
• Python
• Nginx
• AWS

Useful links

• Docker Hub Python
• Docker Hub Postgres
• Docker compose Postgres environment variables
• Quickstart: Docker Compose and Django
• Best practices for writing Dockerfiles