Django

The web framework for perfectionists with deadlines.

Menu

# Documentation

- el
- es
- fr
- id
- ja
- pl
- pt-br
- Language: en

- 1.7
- 1.8
- 1.9
- dev
- Documentation version: 1.10

# Quick install guide

Before you can use Django, you’ll need to get it installed. We have a complete installation guide that covers all the possibilities; this guide will guide you to a simple, minimal installation that’ll work while you walk through the introduction.

## Install Python

Being a Python Web framework, Django requires Python. See What Python version can I use with Django? for details. Python includes a lightweight database called SQLite so you won’t need to set up a database just yet.

Get the latest version of Python at https://www.python.org/download/ or with your operating system’s package manager.

Django on Jython

If you use Jython (a Python implementation for the Java platform), you’ll need to follow a few additional steps. See Running Django on Jython for details.

You can verify that Python is installed by typing `python` from your shell; you should see something like:

    Python 3.4.x
    [GCC 4.x] on linux
    Type "help", "copyright", "credits" or "license" for more information.
    >>>

## Set up a database

This step is only necessary if you’d like to work with a “large” database engine like PostgreSQL, MySQL, or Oracle. To install such a database, consult the database installation information.

## Remove any old versions of Django

If you are upgrading your installation of Django from a previous version, you will need to uninstall the old Django version before installing the new version.

## Install Django

You’ve got three easy options to install Django:

- Install a version of Django provided by your operating system distribution. This is the quickest option for those who have operating systems that distribute Django.
- Install an official release. This is the best approach for most users.
- Install the latest development version. This option is for enthusiasts who want the latest-and-greatest features and aren’t afraid of running brand new code. You might encounter new bugs in the development version, but reporting them helps the development of Django. Also, releases of third-party packages are less likely to be compatible with the development version than with the latest stable release.

Always refer to the documentation that corresponds to the version of Django you’re using!

If you do either of the first two steps, keep an eye out for parts of the documentation marked new in development version. That phrase flags features that are only available in development versions of Django, and they likely won’t work with an official release.

## Verifying

To verify that Django can be seen by Python, type `python` from your shell. Then at the Python prompt, try to import Django:

    >>> import django
    >>> print(django.get_version())
    1.10

You may have another version of Django installed.

## That’s it!

That’s it – you can now move onto the tutorial.

Django at a glance
Writing your first Django app, part 1
Back to Top

# Additional Information

Search:

## Support Django!

- Invest by Rubicoin donated to the Django Software Foundation to support Django development. Donate today!

## Contents

- Quick install guide
  - Install Python
  - Set up a database
  - Remove any old versions of Django
  - Install Django
  - Verifying
  - That’s it!

## Browse

- Prev: Django at a glance
- Next: Writing your first Django app, part 1
- Table of contents
- General Index
- Python Module Index

## You are here:

- Django 1.10 documentation
  - Getting started
    - Quick install guide

## Getting help

FAQ
  Try the FAQ — it's got answers to many common questions.
Index, Module Index, or Table of Contents
  Handy when looking for specific information.
django-users mailing list
  Search for information in the archives of the django-users mailing list, or post a question.
#django IRC channel
  Ask a question in the #django IRC channel, or search the IRC logs to see if it’s been asked before.
Ticket tracker
  Report bugs with Django or Django documentation in our ticket tracker.

## Download:

Offline (Django 1.10): HTML | PDF | ePub
Provided by Read the Docs.