How to get Django

Django is available open-source under the BSD license. We recommend using the latest version of Python 3, but you can also use Python 2.7. See the FAQ for the Python versions supported by each version of Django. Here’s how to get it:

Option 1: Get the latest official version

The latest official version is 1.8. Read the 1.8 release notes, then install it with pip:

pip install Django==1.8

Option 2: Get the latest development version

The latest and greatest Django version is the one that’s in our Git repository (our revision-control system). This is only for experienced users who want to try incoming changes and help identify bugs before an official release. Get it using this shell command, which requires Git:

git clone https://github.com/django/django.git

You can also download a zipped archive of the development version. This archive is updated every time we commit code.

After you get it

See the installation guide for further instructions. Make sure you read the documentation that corresponds to the version of Django you’ve just installed.

And be sure to sign up for the django-users mailing list, where other Django users and the Django developers themselves all hang out to help each other.

Supported Versions

Major releases (A.B, A.B+1, etc.) will happen roughly every six to nine months. These releases will contain new features, improvements to existing features, and such.

Minor releases (A.B.C, etc.) will be issued as needed, often to fix security issues. These releases will be 100% compatible with the associated major release, unless this is impossible for security reasons or to prevent data loss. So the answer to “should I upgrade to the latest minor release?” will always be “yes.”

Additionally, the Django team will occasionally designate certain releases to be “Long-term support” (LTS) releases. LTS releases will get security and data loss fixes applied for a guaranteed period of time, typically 3+ years, regardless of the pace of releases afterwards.

See the supported versions policy for detailed guidelines about what fixes will be backported.

Release Series Latest Release End of mainstream support1 End of extended support2
1.8 LTS 1.8 Upon the release of Django 1.93 Until at least April 2018
1.7 1.7.7 April 1, 2015 Upon the release of Django 1.93
1.6 1.6.11 September 2, 2014 April 1, 2015
1.5 1.5.12 November 6, 2013 September 2, 2014
1.4 LTS 1.4.20 February 26, 2013 October 1, 2015
1.3 1.3.7 March 23, 2012 February 26, 2013

[1] Security fixes, data loss bugs, crashing bugs, major functionality bugs in newly-introduce features, and regressions from older version of Django.
[2] Security fixes and data loss bugs.
[3] Estimated for October 2015.

Back to Top