1. ===================

  2. Quick install guide

  3. ===================

  4. 

  5. Before you can use Django, you'll need to get it installed. We have a

  6. :doc:`complete installation guide </topics/install>` that covers all the

  7. possibilities; this guide will guide you to a minimal installation that'll work

  8. while you walk through the introduction.

  9. 

  10. Install Python

  11. ==============

  12. 

  13. Being a Python web framework, Django requires Python. See

  14. :ref:`faq-python-version-support` for details. Python includes a lightweight

  15. database called SQLite_ so you won't need to set up a database just yet.

  16. 

  17. .. _sqlite: https://www.sqlite.org/

  18. 

  19. Get the latest version of Python at https://www.python.org/downloads/ or with

  20. your operating system's package manager.

  21. 

  22. You can verify that Python is installed by typing ``python`` from your shell;

  23. you should see something like::

  24. 

  25.     Python 3.x.y

  26.     [GCC 4.x] on linux

  27.     Type "help", "copyright", "credits" or "license" for more information.

  28.     >>>

  29. 

  30. Set up a database

  31. =================

  32. 

  33. This step is only necessary if you'd like to work with a "large" database engine

  34. like PostgreSQL, MariaDB, MySQL, or Oracle. To install such a database, consult

  35. the :ref:`database installation information <database-installation>`.

  36. 

  37. Install Django

  38. ==============

  39. 

  40. You've got three options to install Django:

  41. 

  42. * :ref:`Install an official release <installing-official-release>`. This

  43.   is the best approach for most users.

  44. 

  45. * Install a version of Django :ref:`provided by your operating system

  46.   distribution <installing-distribution-package>`.

  47. 

  48. * :ref:`Install the latest development version

  49.   <installing-development-version>`. This option is for enthusiasts who want

  50.   the latest-and-greatest features and aren't afraid of running brand new code.

  51.   You might encounter new bugs in the development version, but reporting them

  52.   helps the development of Django. Also, releases of third-party packages are

  53.   less likely to be compatible with the development version than with the

  54.   latest stable release.

  55. 

  56. .. admonition:: Always refer to the documentation that corresponds to the

  57.     version of Django you're using!

  58. 

  59.     If you do either of the first two steps, keep an eye out for parts of the

  60.     documentation marked **new in development version**. That phrase flags

  61.     features that are only available in development versions of Django, and

  62.     they likely won't work with an official release.

  63. 

  64. 

  65. Verifying

  66. =========

  67. 

  68. To verify that Django can be seen by Python, type ``python`` from your shell.

  69. Then at the Python prompt, try to import Django:

  70. 

  71. .. parsed-literal::

  72. 

  73.     >>> import django

  74.     >>> print(django.get_version())

  75.     |version|

  76. 

  77. You may have another version of Django installed.

  78. 

  79. That's it!

  80. ==========

  81. 

  82. That's it -- you can now :doc:`move onto the tutorial </intro/tutorial01>`.
About Sign Up Leave Feedback Contact