1 | ================================
|
---|
2 | How to install Django on Windows
|
---|
3 | ================================
|
---|
4 |
|
---|
5 | This document will guide you through installing Django and Python for
|
---|
6 | basic usage on Windows. This is meant as a beginners guide for users doing
|
---|
7 | development of Django projects and does not reflect how Django should be
|
---|
8 | installed for production environments.
|
---|
9 |
|
---|
10 | Install Python
|
---|
11 | ==============
|
---|
12 |
|
---|
13 | Django is a Python web framework, thus requiring Python installed on your
|
---|
14 | machine.
|
---|
15 |
|
---|
16 | To install Python on your machine go to http://python.org/download/, and
|
---|
17 | download a Windows MSI installer for Python 2.x (eg. 2.7.1). Django does not
|
---|
18 | currently run on Python 3.x. lSee the :doc:`the Django FAQ </faq/install>`
|
---|
19 | for more information.
|
---|
20 |
|
---|
21 | Once downloaded, run the MSI installer and follow the on screen instructions.
|
---|
22 |
|
---|
23 | Install Setuptools
|
---|
24 | ~~~~~~~~~~~~~~~~~~
|
---|
25 |
|
---|
26 | To install other python software on your computer, setuptools is needed.
|
---|
27 | Download the latest installer for your Python version from
|
---|
28 | http://pypi.python.org/pypi/setuptools#files. Run the installer and follow
|
---|
29 | the on screen instructions.
|
---|
30 |
|
---|
31 | Adding Python to PATH
|
---|
32 | ~~~~~~~~~~~~~~~~~~~~~
|
---|
33 |
|
---|
34 | To be able to execute Python, and related scripts, the directory where
|
---|
35 | you installed Python, and the *Scripts* sub directory,
|
---|
36 | must be on PATH. Only the approach for Windows 7 will be explained,
|
---|
37 | but the other versions of Windows have similar approaches.
|
---|
38 |
|
---|
39 | * Click the Windows button.
|
---|
40 |
|
---|
41 | * Right click on *Computer* and choose *Properties*.
|
---|
42 |
|
---|
43 | * Click *Advanced System Settings* at the bottom of the list on the left side
|
---|
44 | of the opened window.
|
---|
45 |
|
---|
46 | * Click *Environment Variables* at the bottom
|
---|
47 |
|
---|
48 | * Find the *Path* variable in the list of *System variables*,
|
---|
49 | select it and click the *Edit...* button.
|
---|
50 |
|
---|
51 | * The *Variable value* is a semi colon separated list of directories. Make
|
---|
52 | sure both the install directory and the *Scripts* directory is in this list.
|
---|
53 | If not, add them to the end of the list (*C:\\Python27;
|
---|
54 | C:\\Python27\\Scripts*)
|
---|
55 |
|
---|
56 | * Click *OK* to save the changes.
|
---|
57 |
|
---|
58 | Install PIP
|
---|
59 | ===========
|
---|
60 |
|
---|
61 | `PIP <http://www.pip-installer.org/>`_ is a package manager for Python that
|
---|
62 | uses the `Python Package Index <http://pypi.python.org>`_ to install Python
|
---|
63 | packages. PIP will later be used to install Django from PYPI.
|
---|
64 |
|
---|
65 | * Open a command prompt. If you installed Python to a directory where only
|
---|
66 | administrators have write access, the command prompt need to be run as an
|
---|
67 | administrator user.
|
---|
68 |
|
---|
69 | * Execute the following command ``easy_install pip``
|
---|
70 |
|
---|
71 | PIP should now be installed.
|
---|
72 |
|
---|
73 | Database
|
---|
74 | ========
|
---|
75 |
|
---|
76 | From Python version 2.5 SQLite is included in the package. This means that, for
|
---|
77 | local development, it is normally not needed to install other databases. If
|
---|
78 | you want to use another database, like PostgreSQL, MySQL etc.,
|
---|
79 | you are free to install it as well.
|
---|
80 |
|
---|
81 | Install Django
|
---|
82 | ==============
|
---|
83 |
|
---|
84 | Finally Django can be installed quite easily with PIP.
|
---|
85 |
|
---|
86 | In the same command prompt that you used to install PIP,
|
---|
87 | execute the following command: ``pip install django``. This will download and
|
---|
88 | install Django.
|
---|
89 |
|
---|
90 | After the installation has completed, you can verify your Django installation
|
---|
91 | by execution ``django-admin.py --version`` in the command prompt.
|
---|
92 |
|
---|
93 | Common pitfalls
|
---|
94 | ===============
|
---|
95 |
|
---|
96 | * If ``django-admin.py`` only displays the help text, no matter what arguments
|
---|
97 | it is given, there are probably a problem with the file association in
|
---|
98 | Windows. See the solution on `Stackoverflow <http://stackoverflow
|
---|
99 | .com/questions/2640971/windows-is-not-passing-command-line-arguments-to-
|
---|
100 | python-programs-executed-from-th>`_
|
---|
101 |
|
---|