Instalacja Pythona

Jako pythonowy framework webowy Django wymaga Pythona.

Django może być uruchomione na Pythonie w wersji od 2.4 do 2.7.

Możesz pobrać Pythona ze strony http://www.python.org. Jeśli używasz Linuksa lub Mac OS X najprawdopodobniej masz już go zainstalowanego.

Instalacja na serwerze WWW

Jeśli chcesz tylko poeksperymentować z Django, możesz ominąć tę część; Django zawiera lekki serwer http, który możesz wykorzystać do testowania, przez co nie musisz instalować Apache, dopóki nie będziesz potrzebował serwera produkcyjnego.

Jeżeli jednak potrzebujesz serwera produkcyjnego, użyj serwera Apache z mod_wsgi. Szczegółowy opis instalacji mod_wsgi.

Uruchomienie bazy danych

Jeśli planujesz używać bazy danych poprzez API Django, upewnij się, że serwer bazodanowy działa. Django współpracuje z następującymi serwerami: PostgreSQL, MySQL, Oracle i SQLite (przy czym SQLite nie wymaga osobnego procesu serwera bazy danych).

Ponadto sprawdź, czy są zainstalowane odpowiednie sterowniki bazy danych.

• Dla PostgreSQL potrzebujesz pakietu psycopg. Django wspiera zarówno wersję 1 jak i 2 (przy konfiguracji warstwy bazodanowej w Django, dla wersji 1 ustaw postgresql, a dla wersji 2 postgresql_psycopg2).

  Jeśli pracujesz na Windowsie sprawdź nieoficjalne wersje skompilowane na Windows.

• Jeśli używasz MySQL, będziesz potrzebować MySQLdb, w wersji 1.2.1p2 lub wyższej. Zapewne zainteresują Cię też notki specyficzne dla tej bazy, zawarte na stronie MySQL backend.

• Jeśli używasz SQLite i Pythona w wersji 2.3 bądź 2.4, będziesz potrzebować pysqlite. Użyj wersji 2.0.3 lub wyższej. Python 2.5 rozprowadzany jest z wrapperem sqlite w bibliotece standardowej, więc nie musisz w tym przypadku instalować nic ponadto.

• Jeśli używasz Oracle, będziesz potrzebować cx_Oracle, w wersji 4.3.1 bądź wyższej. Zapewne zainteresują Cię też notki specyficzne dla tej bazy, zawarte na stronie Oracle backend.

Jeśli planujesz używać djangowego polecenia manage.py syncdb w celu zautomatyzowania procesu tworzenia tabel w bazie danych dla Twojego modelu, będziesz musiał mieć pewność, że Django ma uprawnienia do tworzenia i modyfikowania tabel w używanej przez ciebie bazie danych. Jeśli planujesz tworzyć tabele ręcznie, możesz zwyczajnie nadać Django uprawnienia SELECT, INSERT, UPDATE i DELETE. W przypadku niektórych baz danych Django będzie potrzebować uprawnień do ALTER TABLE w czasie wykonywania syncdb, lecz nie wpłynie to na deklarację ALTER TABLE tabeli która została utworzona przez syncdb.

Jeśli używasz frameworka testowego Django by zbadać zapytania do bazy danych, będziesz potrzebować uprawnień do utworzenia testowej bazy danych.

Usuń wszelkie stare wersje Django

Jeśli uaktualniasz swoją instalację Django ze starszej wersji, będziesz musiał odinstalować starą wersję przed instalacją nowej.

Jeśli zainstalowałeś Django przy użyciu setup.py install, zwyczajnie je odinstaluj usuwając katalog django z site-packages.

Jeśli zainstalowałeś Django z pythonowego pakietu egg, usuń plik .egg z Django i odniesienie do tego pliku z pliku easy-install.pth. Plik ten również powinien znajdować się w Twoim katalogu site-packages.

python -c "from distutils.sysconfig import get_python_lib; \
           print get_python_lib()"

Instalacja kodu Django

Instrukcje instalacyjne mogą się delikatnie różnić, w zależności od tego czy instalujesz Django z paczek dla określonej dystrybucji, pobierasz ostatnie oficjalne wydanie czy może ostatnią wersję rozwojową.

Bez względu na to jaką metodę wybierzesz, instalacja Django jest naprawdę prosta.