django CMS Divio quickstart

A Dockerised django CMS project, ready to deploy on Divio or another Docker-based cloud platform, and run locally in Docker on your own machine. A Divio account is not required.

This version uses Python 3.8 running and the most up-to-date versions of Django 3.1 and django CMS 3.8.

Try it

git clone git@github.com:divio/django-cms-divio-quickstart.git
cd django-cms-divio-quickstart
docker-compose build
docker-compose run web python manage.py migrate
docker-compose run web python manage.py createsuperuser
docker-compose up
open http://127.0.0.1:8000

For a more complete how-to guide to this project, see Deploy a new django CMS project using the Divio quickstart repository in the Divio Developer Handbook.

Customising the project

This project is ready-to-go without making any changes at all, but also gives you some options.

As-is, it will include a number of useful django CMS plugins and Bootstrap 4 for the frontend. You don't have to use these; they're optional. If you don't want to use them, read through the settings.py and requirements.txt files to see sections that can be removed - in each case, the section is noted with a comment containing the word 'optional'.

Options are also available for using Postgres/MySQL, uWSGI/Gunicorn/Guvicorn, etc.

Again, see Deploy a new django CMS project using the Divio quickstart repository for more guidance on customisation.