Getting Started

Create

Project

Run the command:

django-admin.py startproject mysite

…to create a mysite directory in your current directory.

Application

(For me) a Django project contains one (or more) applications.

If you’re using Django’s database layer (models), you must create a Django app.

Django app - a bundle of Django code, including models and views, that lives together in a single Python package and represents a full Django application.

If you’re building a complex Web site with several unrelated pieces such as an e-commerce system and a message board, you’ll probably want to split those into separate apps so that you’ll be able to reuse them individually in the future.

Create:

python manage.py startapp books

Add the application to settings.py:

INSTALLED_APPS = (
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.sites',
    'mysite.books',
)

The application name is the path to the package, separated by dots..

Development Server

Change into the mysite directory, if you haven’t already, and run the command:

python manage.py runserver

Browse to http://127.0.0.1:8000/

To allow remote workstations to access the development server:

python manage.py runserver 0.0.0.0:8080

Next Steps

If you like, change the TIME_ZONE and LANGUAGE_CODE in settings.py:

TIME_ZONE = 'Europe/London'
LANGUAGE_CODE = 'en-gb'

Database for instructions to configure the database and create a model.