101 lines
3.4 KiB
Plaintext
101 lines
3.4 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. It works with any Python
|
|
version from 2.4 to 2.7 (due to backwards
|
|
incompatibilities in Python 3.0, Django does not currently work with
|
|
Python 3.0; see :doc:`the Django FAQ </faq/install>` for more
|
|
information on supported Python versions and the 3.0 transition), but we
|
|
recommend installing Python 2.5 or later. If you do so, you won't need to set
|
|
up a database just yet: Python 2.5 or later includes a lightweight database
|
|
called SQLite_.
|
|
|
|
.. _sqlite: http://sqlite.org/
|
|
|
|
Get Python at http://www.python.org. If you're running Linux or Mac OS X, you
|
|
probably already have it installed.
|
|
|
|
.. 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 2.5.1 (r251:54863, Jan 17 2008, 19:35:17)
|
|
[GCC 4.0.1 (Apple Inc. build 5465)] on darwin
|
|
Type "help", "copyright", "credits" or "license" for more information.
|
|
>>>
|
|
|
|
Set up a database
|
|
-----------------
|
|
|
|
If you installed Python 2.5 or later, you can skip this step for now.
|
|
|
|
If not, or if you'd like to work with a "large" database engine like PostgreSQL,
|
|
MySQL, or Oracle, 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:
|
|
|
|
* Install a version of Django :doc:`provided by your operating system
|
|
distribution </misc/distributions>`. This is the quickest option for those
|
|
who have operating systems that distribute Django.
|
|
|
|
* :ref:`Install an official release <installing-official-release>`. This
|
|
is the best approach for users who want a stable version number and aren't
|
|
concerned about running a slightly older version of Django.
|
|
|
|
* :ref:`Install the latest development version
|
|
<installing-development-version>`. This is best for users who want the
|
|
latest-and-greatest features and aren't afraid of running brand-new code.
|
|
|
|
.. 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::
|
|
|
|
>>> import django
|
|
>>> print django.get_version()
|
|
1.3
|
|
|
|
|
|
That's it!
|
|
----------
|
|
|
|
That's it -- you can now :doc:`move onto the tutorial </intro/tutorial01>`.
|
|
|
|
|
|
|