97 lines
3.2 KiB
Plaintext
97 lines
3.2 KiB
Plaintext
===================
|
|
Quick install guide
|
|
===================
|
|
|
|
Before you can use Django, you'll need to get it installed. We have a
|
|
:doc:`complete installation guide </topics/install>` that covers all the
|
|
possibilities; this guide will guide you to a simple, minimal installation
|
|
that'll work while you walk through the introduction.
|
|
|
|
Install Python
|
|
==============
|
|
|
|
Being a Python Web framework, Django requires Python. See
|
|
:ref:`faq-python-version-support` for details. Python includes a lightweight
|
|
database called SQLite_ so you won't need to set up a database just yet.
|
|
|
|
.. _sqlite: https://sqlite.org/
|
|
|
|
Get the latest version of Python at https://www.python.org/downloads/ or with
|
|
your operating system's package manager.
|
|
|
|
.. admonition:: Django on Jython
|
|
|
|
If you use Jython_ (a Python implementation for the Java platform), you'll
|
|
need to follow a few additional steps. See :doc:`/howto/jython` for details.
|
|
|
|
.. _jython: http://www.jython.org/
|
|
|
|
You can verify that Python is installed by typing ``python`` from your shell;
|
|
you should see something like::
|
|
|
|
Python 3.x.y
|
|
[GCC 4.x] on linux
|
|
Type "help", "copyright", "credits" or "license" for more information.
|
|
>>>
|
|
|
|
Set up a database
|
|
=================
|
|
|
|
This step is only necessary if you'd like to work with a "large" database engine
|
|
like PostgreSQL, MySQL, or Oracle. To install such a database, consult the
|
|
:ref:`database installation information <database-installation>`.
|
|
|
|
Remove any old versions of Django
|
|
=================================
|
|
|
|
If you are upgrading your installation of Django from a previous version, you
|
|
will need to :ref:`uninstall the old Django version before installing the new
|
|
version <removing-old-versions-of-django>`.
|
|
|
|
Install Django
|
|
==============
|
|
|
|
You've got three easy options to install Django:
|
|
|
|
* :ref:`Install an official release <installing-official-release>`. This
|
|
is the best approach for most users.
|
|
|
|
* Install a version of Django :ref:`provided by your operating system
|
|
distribution <installing-distribution-package>`.
|
|
|
|
* :ref:`Install the latest development version
|
|
<installing-development-version>`. This option is for enthusiasts who want
|
|
the latest-and-greatest features and aren't afraid of running brand new code.
|
|
You might encounter new bugs in the development version, but reporting them
|
|
helps the development of Django. Also, releases of third-party packages are
|
|
less likely to be compatible with the development version than with the
|
|
latest stable release.
|
|
|
|
.. admonition:: Always refer to the documentation that corresponds to the
|
|
version of Django you're using!
|
|
|
|
If you do either of the first two steps, keep an eye out for parts of the
|
|
documentation marked **new in development version**. That phrase flags
|
|
features that are only available in development versions of Django, and
|
|
they likely won't work with an official release.
|
|
|
|
|
|
Verifying
|
|
=========
|
|
|
|
To verify that Django can be seen by Python, type ``python`` from your shell.
|
|
Then at the Python prompt, try to import Django:
|
|
|
|
.. parsed-literal::
|
|
|
|
>>> import django
|
|
>>> print(django.get_version())
|
|
|version|
|
|
|
|
You may have another version of Django installed.
|
|
|
|
That's it!
|
|
==========
|
|
|
|
That's it -- you can now :doc:`move onto the tutorial </intro/tutorial01>`.
|