How to get Django

Django is open source  software under the BSD license . We recommend using the latest version of Python 3. The last version to support Python 2.7 is Django 1.11 LTS. See the  FAQ for supported Python versions for each Django version . Here's how to get it:

Option 1: Get the latest official release

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

<span style="color:#0c4b33"><code>pip install Django==2.2</code></span>

Option 2: Get the latest development version

The latest and greatest version of Django is our Git repository (our version control system). This is only for experienced users who want to try incoming changes and help identify bugs before the official release. Get it with this shell command, which requires Git :

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

You can also download  a gzipped tarball of the development version . This archive is updated with every code commit.

after getting it

See the installation guide for detailed instructions . Be sure to read the documentation corresponding to the version of Django you just installed.

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

Supported Versions

Feature releases (AB, AB+1, etc.) are released approximately every eight months. These releases will contain new features, improvements to existing features, and more.

Patch releases (ABC, etc.) will be released as needed to fix bugs and/or security issues. These versions will be 100% compatible with the relevant functional versions, except for security reasons or to prevent data loss, which is not possible. So the answer to "Should I upgrade to the latest patch version?" is always "yes".

Certain feature releases will be designated as Long Term Support (LTS) releases . These releases will receive security and data loss fixes for a guaranteed period of time (usually three years).

For detailed guidance on the patches that will be backported, see  Supported Release Policies .

Here's what the future roadmap looks like:

[1] Security fixes, data loss bugs, crash bugs, major feature bugs in newly introduced features, and regression of older versions of Django.
[2] Security fixes and data loss bugs.
[3] The latest version of Python 2.7 is supported.