A modern Django (1.5) project skeleton.
Switch branches/tags
Nothing to show
Latest commit d4631bb Jan 30, 2014 @rdegges Merge pull request #49 from dulaccc/improve-compress-settings
Failed to load latest commit information.
docs Updated getting-started.rst Oct 30, 2013
reqs update django-celery version Aug 3, 2013
Procfile Upgrading celery CLI calls. Nov 4, 2012
README.md Removed Reference to Django 1.4 Jul 6, 2013
fabfile.py Fixing missing comma, thanks @jbarone! Oct 3, 2013
gunicorn.py.ini Reducing gunicorn instances Sep 24, 2012
runtime.txt Changes for Django 1.5 compatibility. django-debug-toolbar still caus… Jun 4, 2013



A modern Django (1.5) project skeleton.

A fancy Django project skeleton


  • author: Randall Degges
  • email: rdegges@gmail.com
  • status: maintained, in development
  • notes: Have feedback? Please send me an email. This project is still in its infancy, and will be changing rapidly.


For background, see: http://rdegges.com/deploying-django

Essentially--deploying Django projects is hard. There are lots of things you need to take into consideration. Being a Django user for years, I believe I've found some extremely useful patterns to help manage all sorts of Django sites (from the very smallest apps, to the largest).

This project is meant to be a boilerplate project for starting development. It is heavily opinionated in terms of services and tools--but I think the tradeoff is worthwhile.


The full project documentation is hosted at RTFD: http://django-skel.rtfd.org/. They are continuously updated to reflect changes and information about the project, so be sure to read them before using this boilerplate.


django-skel currently supports Django 1.5. To create a new django-skel base project, run the following command (this assumes you have Django 1.5 installed already):

$ django-admin.py startproject --template=https://github.com/rdegges/django-skel/zipball/master woot
$ heroku config:add DJANGO_SETTINGS_MODULE=myproject.settings.prod

Where woot is the name of the project you'd like to create.

This is possible because Django 1.5's startproject command allows you to fetch a project template over HTTP (which is what we're doing here).

While not strictly required, it is also recommended to do

 $ heroku config:add SECRET_KEY=putsomethingfairlycomplexhere

The production settings pull SECRET_KEY from environment but fallbacks to a value which is generated mainly for development environment.

This setup allows you to easily keep your site in a public repo if you so wish without causing opening a route to attack your Django passwords.