Hello world in Django with Docker
This repository serves as an example to run a simple Django app using Docker. It includes the minimum required for such an app, and follows the KISS principle: It uses a simple SQLite database, runs Python with a few Gunicorn workers and serves static files without a reverse proxy as only the web admin makes use of those.
You need will need Docker installed and running and an internet connexion. The configuration was tested with Docker 1.12.3 on Ubuntu 16.04 LTS.
Clone this repository, and customize the setting ALLOWED_HOSTS in the file hellodjango/hellodjango/settings.py with the domain names you
will want to use for this web app. Localhost is already included if
you just want to use that.
Build the Docker image with
docker build -t hellodjango .
Then launch a container with
docker run -p80:8000 -v /data/hellodjango:/data hellodjango
You should now be able to browse the (empty) index page on http://localhost/.
To create new database objects, you will need an access to the web admin. To
create your superuser account, get the id of your Docker container with
docker ps, then run
docker exec -ti $CONTAINER_ID /opt/venv-hellodjango/bin/python manage.py createsuperuser
You should now be able to create new database objects with http://localhost/admin/helloworld/databaseobject/add/.
You should now see the objects you have created listed on localhost/hello-world/ and see a greeting for the first object on localhost:8000/hello-world/1
Finally, you can configure your local DNS configuration to access this a greeting from other devices with an URL like http://some-django-box.dev/hello-world/<id>. If you get Bad Request (400) error pages, check the ALLOWED_HOSTS setting above and rebuild your image.