This is quite simple, just invoke the Cookiecutter template to create a new project:


You will be prompted to anwser to some inputs about your project:


[Default:Project name]

Project name, should be unique into your repository host;


[Default:A slug created from project name]

This will be used as the repository name;



Your username to use to push the repository;



The hostname of the repository host;


[Default:A random key]

The secret key to use in Django settings, you should let the default value;

Then you will be prompted to define the application to enable within your project:



Enable the accounts component;



Enable a basic contact form with an optional captcha field;



Enable Porticus application;



Enable Slideshows application;



Enable Social agregator application;



Enable Zinnia application;



Enable CMS internationalization;

Take care that question about applications require a strict “yes” value to enable them, all other value are considered as a “no”.


In future, Cookiecutter will probably implement a better system to have real questions, but for now their labels are just keywords.

Created projects usage

Once a project has been created, you need to build it to use it. The process is simple. Do it in your project directory:

make install

When it’s finished, active the virtual environment:

source bin/active

You can then use the project on the development server:

django-instance runserver

Note is some sort of alias that mean “bind this server on my ip”, so if your local ip is “”, the server will be reachable in your browser with the url


Note the :8001 that mean “bind the server on this port”, this is a required part when you specify an IP. Commonly you can’t bind on the port 80 so allways prefer to use a port starting from 8001.


If you don’t know your local IP, you can use that is an internal alias to mean “my own network card”, but this IP cannot be reached from other computers (because they have also this alias linked to their own network card).

The first required action is the creation of a CMS page for the home page and also you should fill-in the site name and its domain under Administration > Sites > Sites > Add site.