{"title":"FAQ: Installation","version":"3.2","locale":"en","docname":"faq/install","url":"/en/3.2/faq/install/","canonical":"https://djangodocs.dev/en/3.2/faq/install/","summary":"How do I get started? Link to this heading # Download the code . Install Django (read the installation guide ). Walk through the tutorial . Check out the rest of…","html":"

FAQ: InstallationLink to this heading#

\n
\n

How do I get started?Link to this heading#

\n
    \n

  1. Download the code.

    2. \n

  2. Install Django (read the installation guide).

    3. \n

  3. Walk through the tutorial.

    4. \n

  4. Check out the rest of the documentation, and ask questions if you\nrun into trouble.

    5. \n
\n
\n
\n

What are Django’s prerequisites?Link to this heading#

\n

Django requires Python. See the table in the next question for the versions of\nPython that work with each version of Django. Other Python libraries may be\nrequired for some use cases, but you’ll receive an error about them as they’re\nneeded.

\n

For a development environment – if you just want to experiment with Django –\nyou don’t need to have a separate Web server installed or database server.

\n

Django comes with its own lightweight development server.\nFor a production environment, Django follows the WSGI spec, PEP 3333, which\nmeans it can run on a variety of web servers. See Deploying Django for more information.

\n

Django runs SQLite by default, which is included in Python installations.\nFor a production environment, we recommend PostgreSQL; but we also officially\nsupport MariaDB, MySQL, SQLite, and Oracle. See Supported Databases for more information.

\n
\n
\n

What Python version can I use with Django?Link to this heading#

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Django version

Python versions

2.2

3.5, 3.6, 3.7, 3.8 (added in 2.2.8), 3.9 (added in 2.2.17)

3.0

3.6, 3.7, 3.8, 3.9 (added in 3.0.11)

3.1

3.6, 3.7, 3.8, 3.9 (added in 3.1.3)

3.2

3.6, 3.7, 3.8, 3.9, 3.10 (added in 3.2.9)

\n
\n

For each version of Python, only the latest micro release (A.B.C) is officially\nsupported. You can find the latest micro version for each series on the Python\ndownload page.

\n

Typically, we will support a Python version up to and including the first\nDjango LTS release whose security support ends after security support for that\nversion of Python ends. For example, Python 3.3 security support ended\nSeptember 2017 and Django 1.8 LTS security support ended April 2018. Therefore\nDjango 1.8 is the last version to support Python 3.3.

\n
\n
\n

What Python version should I use with Django?Link to this heading#

\n

Since newer versions of Python are often faster, have more features, and are\nbetter supported, the latest version of Python 3 is recommended.

\n

You don’t lose anything in Django by using an older release, but you don’t take\nadvantage of the improvements and optimizations in newer Python releases.\nThird-party applications for use with Django are free to set their own version\nrequirements.

\n
\n
\n

Should I use the stable version or development version?Link to this heading#

\n

Generally, if you’re using code in production, you should be using a\nstable release. The Django project publishes a full stable release\nevery nine months or so, with bugfix updates in between. These stable\nreleases contain the API that is covered by our backwards\ncompatibility guarantees; if you write code against stable releases,\nyou shouldn’t have any problems upgrading when the next official\nversion is released.

\n
","rootId":"faq-installation","toc":[{"title":"How do I get started?","anchor":"how-do-i-get-started","children":[]},{"title":"What are Django’s prerequisites?","anchor":"what-are-django-s-prerequisites","children":[]},{"title":"What Python version can I use with Django?","anchor":"what-python-version-can-i-use-with-django","children":[]},{"title":"What Python version should I use with Django?","anchor":"what-python-version-should-i-use-with-django","children":[]},{"title":"Should I use the stable version or development version?","anchor":"should-i-use-the-stable-version-or-development-version","children":[]}],"breadcrumbs":[{"docname":"faq/index","title":"Django FAQ","url":"/en/3.2/faq/"}],"prev":{"docname":"faq/general","title":"FAQ: General","url":"/en/3.2/faq/general/"},"next":{"docname":"faq/usage","title":"FAQ: Using Django","url":"/en/3.2/faq/usage/"},"formats":{"html":"/en/3.2/faq/install/","markdown":"/en/3.2/faq/install.md","json":"/en/3.2/faq/install.json"},"source":"https://github.com/django/django/blob/stable/3.2.x/docs/faq/install.txt","official":"https://docs.djangoproject.com/en/3.2/faq/install/","inVersions":["dev","6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9","1.8"],"inLocales":["en","zh-hans","fr","ja","id","it","pt-br","ko","es","el","pl"]}