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