Официальные релизы имеют имена версий подобные 1.0.3 или 1.1, а последный релиз всегда доступен на http://www.djangoproject.com/download/. Для его установки, сначала надо скачать архив, который будет иметь имя подобное Django-1.0.2-final.tar.gz. Затем, надо развернуть архив и запустить setup.py install, как вы это делаете с большинством библиотек Python.

Ниже показано как этот процесс выглядит на Unix системах:

Если вы используете дистрибутив Linux, который содержит пакет с Django, будет хорошей идеей воспользоваться этим пакетом. Это позволит вам получать критические обновления совместно с остальными пакетами системы.

На Windows мы рекомендуем использовать 7-Zip (http://www.djangoproject.com/r/7zip/) для распаковки .tar.gz файлов. После распаковки запустите DOS оболочку («Command Prompt») с административными привелегиями и выполните следующую команду в каталоге, имя которого начинается с Django-:

python setup.py install

Самая последняя версия Django называется стволом (trunk) и она доступна из Subversion репозитория Django. Вы должны рассмотреть возможность установки этой версии, если вам требуется работать с новыми возможностями или если вы желаете совершенствовать Django.

Subversion — это свободная система управления версиями с открытым исходным кодом, подобная CVS. Команда разработчиков Django использует её для управления базой разрабатываемого кода. Вы можете использовать клиент Subversion для получения свежего исходного кода Django и в любое время вы можете обновлять свою версию кода для получения свежих обновлений от других разработчиков.

Используя код со ствола, следует помнить, что нет гарантий того, что всё в Django работоспособно на данный момент. Несмотря на это команда разработчиков использует ствол для работы своих сайтов и борется за их стабильную работу.

Для получения кода со ствола делайте так:

После получения кода и выполнения вышеприведённых шагов нет никакой необходимости выполнять команду:

python setup.py install

Все необходимые действия вы уже проделали вручную!

Из-за того, что ствол Django обновляется часто, для исправления ошибок и добавления новых возможностей, вероятно вы пожелаете обновлять его на регулярной основе. Для обновления исходного кода надо просто в каталоге djtrunk выполнить команду:

svn update

При выполнении этой команды, Subversion подключается к http://code.djangoproject.com, определяет наличие изменений кода Django и обновляет вашу локальную версию кода, скачивая только изменения. Это достаточно быстро.

Наконец, если вы используете код из ствола, вы должны знать как определить номер текущей версии кода, на которым вы работаете. Знание номера версия имеет ключевое значение, если вам понадобится помощь от сообщества пользователей Django или если вы соберётесь усовершенствовать среду. В этих случаях вам потребуется указать версию кода, так же известную как «номер ревизии», которую вы используете. Для того, чтобы узнать номер ревизии, наберите svn info каталоге с кодом Django и посмотрите на строчку с текстом «Revision:». Этот номер увеличивается при каждом изменении в коде Django, будь то исправлением ошибки, добавлением новых возможностей, изменением в документации или чем-то ещё. Некоторые пользователи Django измеряют свою крутость, говоря: «Я пользуюсь Django с версии [вставьте тут номер ревизии поменьше].».