2016-01-03 10:56:22 +00:00
|
|
|
=================
|
2008-08-23 22:25:40 +00:00
|
|
|
FAQ: Installation
|
|
|
|
=================
|
|
|
|
|
|
|
|
How do I get started?
|
2016-01-03 10:56:22 +00:00
|
|
|
=====================
|
2008-08-23 22:25:40 +00:00
|
|
|
|
2011-10-14 00:12:01 +00:00
|
|
|
#. `Download the code`_.
|
|
|
|
#. Install Django (read the :doc:`installation guide </intro/install>`).
|
|
|
|
#. Walk through the :doc:`tutorial </intro/tutorial01>`.
|
|
|
|
#. Check out the rest of the :doc:`documentation </index>`, and `ask questions`_ if you
|
|
|
|
run into trouble.
|
2008-08-23 22:25:40 +00:00
|
|
|
|
2012-03-13 17:53:31 +00:00
|
|
|
.. _`Download the code`: https://www.djangoproject.com/download/
|
|
|
|
.. _ask questions: https://www.djangoproject.com/community/
|
2008-08-23 22:25:40 +00:00
|
|
|
|
|
|
|
What are Django's prerequisites?
|
2016-01-03 10:56:22 +00:00
|
|
|
================================
|
2008-08-23 22:25:40 +00:00
|
|
|
|
2015-06-15 13:43:35 +00:00
|
|
|
Django requires Python. See the table in the next question for the versions of
|
|
|
|
Python that work with each version of Django. Other Python libraries may be
|
2019-10-03 16:41:33 +00:00
|
|
|
required for some use cases, but you'll receive an error about them as they're
|
|
|
|
needed.
|
2008-08-23 22:25:40 +00:00
|
|
|
|
|
|
|
For a development environment -- if you just want to experiment with Django --
|
2021-07-23 06:48:16 +00:00
|
|
|
you don't need to have a separate web server installed or database server.
|
2008-08-23 22:25:40 +00:00
|
|
|
|
2019-10-03 16:41:33 +00:00
|
|
|
Django comes with its own :djadmin:`lightweight development server<runserver>`.
|
|
|
|
For a production environment, Django follows the WSGI spec, :pep:`3333`, which
|
|
|
|
means it can run on a variety of web servers. See :doc:`Deploying Django
|
|
|
|
</howto/deployment/index>` for more information.
|
|
|
|
|
|
|
|
Django runs `SQLite`_ by default, which is included in Python installations.
|
|
|
|
For a production environment, we recommend PostgreSQL_; but we also officially
|
|
|
|
support MariaDB_, MySQL_, `SQLite`_, and Oracle_. See :doc:`Supported Databases
|
|
|
|
</ref/databases>` for more information.
|
2008-08-23 22:25:40 +00:00
|
|
|
|
2014-12-19 15:25:57 +00:00
|
|
|
.. _Python: https://www.python.org/
|
2016-10-25 15:43:32 +00:00
|
|
|
.. _PostgreSQL: https://www.postgresql.org/
|
2019-05-27 17:59:49 +00:00
|
|
|
.. _MariaDB: https://mariadb.org/
|
2015-11-29 16:29:46 +00:00
|
|
|
.. _MySQL: https://www.mysql.com/
|
2018-12-22 23:11:36 +00:00
|
|
|
.. _`SQLite`: https://www.sqlite.org/
|
2017-05-20 15:51:21 +00:00
|
|
|
.. _Oracle: https://www.oracle.com/
|
2008-08-23 22:25:40 +00:00
|
|
|
|
2015-06-17 15:27:25 +00:00
|
|
|
.. _faq-python-version-support:
|
|
|
|
|
2012-03-16 18:41:31 +00:00
|
|
|
What Python version can I use with Django?
|
2016-01-03 10:56:22 +00:00
|
|
|
==========================================
|
2012-03-16 18:41:31 +00:00
|
|
|
|
|
|
|
============== ===============
|
|
|
|
Django version Python versions
|
|
|
|
============== ===============
|
2021-10-05 11:30:41 +00:00
|
|
|
3.2 3.6, 3.7, 3.8, 3.9, 3.10 (added in 3.2.9)
|
2022-10-26 18:10:33 +00:00
|
|
|
4.0 3.8, 3.9, 3.10
|
|
|
|
4.1 3.8, 3.9, 3.10, 3.11 (added in 4.1.3)
|
2023-11-18 14:56:29 +00:00
|
|
|
4.2 3.8, 3.9, 3.10, 3.11, 3.12 (added in 4.2.8)
|
2023-01-06 06:31:13 +00:00
|
|
|
5.0 3.10, 3.11, 3.12
|
2023-09-08 08:54:07 +00:00
|
|
|
5.1 3.10, 3.11, 3.12
|
2012-03-16 18:41:31 +00:00
|
|
|
============== ===============
|
2009-10-23 19:30:23 +00:00
|
|
|
|
2014-12-18 16:55:33 +00:00
|
|
|
For each version of Python, only the latest micro release (A.B.C) is officially
|
|
|
|
supported. You can find the latest micro version for each series on the `Python
|
|
|
|
download page <https://www.python.org/downloads/>`_.
|
2008-12-09 22:39:58 +00:00
|
|
|
|
2015-06-15 13:43:35 +00:00
|
|
|
Typically, we will support a Python version up to and including the first
|
2015-06-22 16:06:23 +00:00
|
|
|
Django LTS release whose security support ends after security support for that
|
2019-10-03 16:41:33 +00:00
|
|
|
version of Python ends. For example, Python 3.3 security support ended
|
|
|
|
September 2017 and Django 1.8 LTS security support ended April 2018. Therefore
|
|
|
|
Django 1.8 is the last version to support Python 3.3.
|
2015-06-15 13:43:35 +00:00
|
|
|
|
2013-07-01 09:44:59 +00:00
|
|
|
What Python version should I use with Django?
|
2016-01-03 10:56:22 +00:00
|
|
|
=============================================
|
2012-09-07 21:12:11 +00:00
|
|
|
|
2013-07-01 09:44:59 +00:00
|
|
|
Since newer versions of Python are often faster, have more features, and are
|
2017-01-18 16:51:29 +00:00
|
|
|
better supported, the latest version of Python 3 is recommended.
|
2013-07-01 09:44:59 +00:00
|
|
|
|
|
|
|
You don't lose anything in Django by using an older release, but you don't take
|
|
|
|
advantage of the improvements and optimizations in newer Python releases.
|
2020-05-01 12:37:21 +00:00
|
|
|
Third-party applications for use with Django are free to set their own version
|
|
|
|
requirements.
|
2008-08-23 22:25:40 +00:00
|
|
|
|
2010-05-06 01:20:11 +00:00
|
|
|
Should I use the stable version or development version?
|
2016-01-03 10:56:22 +00:00
|
|
|
=======================================================
|
2008-08-23 22:25:40 +00:00
|
|
|
|
2010-05-06 01:20:11 +00:00
|
|
|
Generally, if you're using code in production, you should be using a
|
|
|
|
stable release. The Django project publishes a full stable release
|
2023-05-08 06:34:23 +00:00
|
|
|
every eight months or so, with bugfix updates in between. These stable
|
2010-05-06 01:20:11 +00:00
|
|
|
releases contain the API that is covered by our backwards
|
|
|
|
compatibility guarantees; if you write code against stable releases,
|
|
|
|
you shouldn't have any problems upgrading when the next official
|
|
|
|
version is released.
|