/docs/intro/install.txt

  1Quick install guide
  2===================
  3
  4Before you can use Django, you'll need to get it installed. We have a
  5:doc:`complete installation guide </topics/install>` that covers all the
  6possibilities; this guide will guide you to a simple, minimal installation
  7that'll work while you walk through the introduction.
  8
  9Install Python
 10--------------
 11
 12Being a Python Web framework, Django requires Python. It works with any Python
 13version from 2.4 to 2.7 (due to backwards
 14incompatibilities in Python 3.0, Django does not currently work with
 15Python 3.0; see :doc:`the Django FAQ </faq/install>` for more
 16information on supported Python versions and the 3.0 transition), but we
 17recommend installing Python 2.5 or later. If you do so, you won't need to set
 18up a database just yet: Python 2.5 or later includes a lightweight database
 19called SQLite_.
 20
 21.. _sqlite: http://sqlite.org/
 22
 23Get Python at http://www.python.org. If you're running Linux or Mac OS X, you
 24probably already have it installed.
 25
 26.. admonition:: Django on Jython
 27
 28    If you use Jython_ (a Python implementation for the Java platform), you'll
 29    need to follow a few additional steps. See :doc:`/howto/jython` for details.
 30
 31.. _jython: http://www.jython.org/
 32
 33You can verify that Python is installed by typing ``python`` from your shell;
 34you should see something like::
 35
 36    Python 2.5.1 (r251:54863, Jan 17 2008, 19:35:17)
 37    [GCC 4.0.1 (Apple Inc. build 5465)] on darwin
 38    Type "help", "copyright", "credits" or "license" for more information.
 39    >>>
 40
 41Set up a database
 42-----------------
 43
 44If you installed Python 2.5 or later, you can skip this step for now.
 45
 46If not, or if you'd like to work with a "large" database engine like PostgreSQL,
 47MySQL, or Oracle, consult the :ref:`database installation information
 48<database-installation>`.
 49
 50Remove any old versions of Django
 51---------------------------------
 52
 53If you are upgrading your installation of Django from a previous version, you
 54will need to :ref:`uninstall the old Django version before installing the new
 55version <removing-old-versions-of-django>`.
 56
 57Install Django
 58--------------
 59
 60You've got three easy options to install Django:
 61
 62    * Install a version of Django :doc:`provided by your operating system
 63      distribution </misc/distributions>`. This is the quickest option for those
 64      who have operating systems that distribute Django.
 65
 66    * :ref:`Install an official release <installing-official-release>`. This
 67      is the best approach for users who want a stable version number and aren't
 68      concerned about running a slightly older version of Django.
 69
 70    * :ref:`Install the latest development version
 71      <installing-development-version>`. This is best for users who want the
 72      latest-and-greatest features and aren't afraid of running brand-new code.
 73
 74.. admonition:: Always refer to the documentation that corresponds to the
 75    version of Django you're using!
 76
 77    If you do either of the first two steps, keep an eye out for parts of the
 78    documentation marked **new in development version**. That phrase flags
 79    features that are only available in development versions of Django, and
 80    they likely won't work with an official release.
 81
 82
 83Verifying
 84---------
 85
 86To verify that Django can be seen by Python, type ``python`` from your shell.
 87Then at the Python prompt, try to import Django::
 88
 89    >>> import django
 90    >>> print django.get_version()
 91    1.3
 92
 93
 94That's it!
 95----------
 96
 97That's it -- you can now :doc:`move onto the tutorial </intro/tutorial01>`.
 98
 99
100