Official Django Tutorials logo

Official Django Tutorials

Free

Learn Django by building a poll application step by step.

FreeFree tier
Type
Open Source

About Official Django Tutorials

The official Django tutorial series provides a hands-on, step-by-step introduction to building web applications with the Django framework. The tutorial walks through creating a basic poll application, covering project setup, models, views, templates, forms, testing, static files, and the admin interface. It is designed for beginners and includes sections on getting help, installation, and understanding Django's model-view-template architecture. The documentation is organized into tutorials, topic guides, reference guides, and how-to guides.

Key Features

Step-by-step creation of a poll application from scratch
Covers project setup, models, views, templates, forms, testing, and static files
Includes admin site customization
Covers database configuration and migrations
Provides guidance on reusable apps and third-party packages
Structured into tutorials, topic guides, reference guides, and how-to guides

Pros & Cons

Pros
  • Completely free and open-source
  • Official and authoritative documentation from the Django project
  • Covers both fundamentals and advanced topics
  • Includes hands-on, practical examples
  • Well-organized with multiple learning paths (tutorials, topic guides, reference)
Cons
  • The tutorial version (3.0) is outdated and no longer supported; users should check the latest version
  • Assumes Django is already installed, requiring prior setup knowledge
  • Limited to the scope of the poll application; does not cover real-world deployment or complex architectures

Best For

Learning Django for beginnersBuilding a basic web application with polls and votingUnderstanding Django's model-view-template architectureSetting up a Django project with admin interfaceExploring Django's ORM, views, and template system

FAQ

How do I check if Django is installed?
Run `python -m django --version` in a shell prompt. If Django is installed, you will see the version number; otherwise, you will get an error.
Where should I store my Django project code?
Place your code outside the web server's document root (e.g., /home/mycode) to avoid security risks. Do not put it under /var/www.
What Python version is supported for Django 3.0?
Django 3.0 supports Python 3.6 and later.
Where can I get help if I'm stuck on the tutorial?
Visit the Getting Help section of the FAQ or the FAQ: Getting Help page for support and community questions.