Как установить django
Перед началом работы с Django нам естественно надо установить интерпретатор Python. Подоробнее об этом можно почитать здесь.
Существуют разные способы установки Django. Рассмотрим рекомендуемый способ.
Пакетный менеджер pip
Пакеты Django размещаются в центральном репозитории для большинства пакетов Python — Package Index (PyPI). И для установки из этого репозитория нам потребуется пакетный менеджер pip . Менеджер pip позволяет загружать пакеты и управлять ими. Обычно при установке python также устанавливается и менеджер pip. В этом случае мы можем проверить версию менеджера, выполнив в командной строке/терминале команду pip -V (V — с заглавной буквы):
C:\Users\eugen>pip -V pip 22.0.4 from C:\Users\eugen\AppData\Local\Programs\Python\Python310\lib\site-packages\pip (python 3.10) C:\Users\eugen>
Если pip не установлен, то мы увидим ошибку типа
"pip" не является внутренней или внешней командой, исполняемой программой или пакетным файлом
В этом случае нам надо установить pip. Для этого можно выполнить в командной строке/консоли следующую команду:
python -m ensurepip --upgrade
Если pip ранее уже был установлен, то можно его обновить с помощью команды
pip install --upgrade pip
Установка виртуальной среды
Виртуальная среда или venv не является неотъемлимой частью разработки на Django. Однако ее рекомендуется использовать, так как она позволяет создать множество виртуальных сред Python на одной операционной системе. Благодаря виртуальной среде приложение может запускаться независимо от других приложений на Python.
В принципе можно запускать приложения на Django и без виртуальной среды. В этом случае все пакеты Django устанавливаются глобально. Однако что если после создания первого приложения выйдет новая версия Django? Если мы захотим использовать для второго проекта новую версию Django, то из-за глобальной установки пакетов придется обновлять первый проект, который использует старую версию. Это потребует некоторой дополнительной работы по обновлению, так как не всегда соблюдается обратная совместимость между пакетами. Если мы решим использовать для второго проекта старую версию, то мы лишиемся потенциальных преимуществ новой версии. И использование виртуальной среды как раз позволяет разграничить пакеты для каждого проекта.
Для работы с виртуальной средой в python применяется встроенный модуль venv
Итак, создадим вируальную среду. Вначале определим каталог для проектов django. Например, пусть это будет каталог C:\django . Прежде всего перейдем в терминале/командной строке в этот каталог с помощью команды cd.
cd C:\django
Затем для создания виртуальной среды выполним следующую команду:
python -m venv .venv
Модулю venv передается название среды, которая в данном случае будет называться «.venv». Для наименования виртуальных сред нет каких-то определенных условностей. Пример консольного вывода:
C:\Users\eugen>cd C:\djangoПереход к папке будущей виртуальной среды C:\django>python -m venv .venvСоздание виртуальной среды C:\django>
После этого в текущей папке (C:\django) будет создан подкаталог «.venv».
Активация виртуальной среды
Для использования виртуальную среду надо активировать. И каждый раз, когда мы будем работать с проектом Django, связанную с ним виртуальную среду надо активировать . Например, активируем выше созданную среду, которая располагается в текущем каталоге в папке .venv. Процесс активации немного отличается в зависимости от операционной системы и от того, какие инструменты применяются. Так, в Windows можно использовать командную строку и PowerShell, но между ними есть отличия.
Активация в Windows в коммандной строке
Если наша ОС — Windows, то в папке .venv/Scripts/ мы можем найти файл activate.bat ), который активирует виртуальную среду. Так, в Windows активация виртуальной среды в коммандной строке будет выглядеть таким образом:
.venv\Scripts\activate.bat
Активация в Windows в PowerShell
Также при работе на Windows в папке .venv/Scripts/ мы можем найти файл activate.ps1 , который также активирует виртуальную среду, но применяется только в PowerShell. Но при работе с PowerShell следует учитывать, что по умолчанию в этой оболочке запрещено применять скрипты. Поэтому перед активацией среды необходимо установить разрешения для текущего пользователя. Поэтому для активации виртуальной среды в PowerShell необходимо выполнить две следующих команды:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser .venv\Scripts\Activate.ps1
Активация в Linux и MacOS
Для Linux и MacOS активация будет производиться с помощью следующей команды:
source .venv/bin/activate
Далее я буду приводить примеры на основе командной строки Windows, однако все остальные примеры не будут зависеть от того, что используется — PowerShell или командная строка, Windows, Linux или MacOS. В любом случае после успешной активации слева от текущего каталога мы увидим в скобках название виртуальной среды:
C:\Users\eugen>cd C:\django C:\django>python -m venv .venv C:\django>.venv\Scripts\activate.batАктивация виртуальной среды (.venv) C:\django> Виртуальная среда активирована
Установка Django
После активации виртуальной среды для установки Django выполним в консоли следующую команду
python -m pip install Django
Она устанавливает последнюю версию Django.
(.venv) C:\django>python -m pip install Django Collecting Django Using cached Django-4.1-py3-none-any.whl (8.1 MB) Collecting sqlparse>=0.2.2 Using cached sqlparse-0.4.2-py3-none-any.whl (42 kB) Collecting tzdata Using cached tzdata-2022.1-py2.py3-none-any.whl (339 kB) Collecting asgiref=3.5.2 Using cached asgiref-3.5.2-py3-none-any.whl (22 kB) Installing collected packages: tzdata, sqlparse, asgiref, Django Successfully installed Django-4.1 asgiref-3.5.2 sqlparse-0.4.2 tzdata-2022.1 (.venv) C:\django>
Если нам интересует конкретная версия Django, то мы можем указать ее при установке:
python -m pip install django~=4.0.0
Проверка установки
Чтобы убедиться, что все установлено правильно, мы можем перейти к интерпретатору python. Для этого введем в терминале команду
python
И затем выполним последовательно следующие две инструкции:
>>> import django >>> print(django.get_version())
Консольный вывод в моем случае:
(.venv) C:\django>python Python 3.10.1 (tags/v3.10.1:2cd268a, Dec 6 2021, 19:10:37) [MSC v.1929 64 bit (AMD64)] on win32 Type "help", "copyright", "credits" or "license" for more information. >>> import django >>> print(django.get_version()) 4.1 >>>
Деактивация виртуальной среды
После окончания работы с виртуальной средой мы можем ее деактивировать с помощью команды:
Установка Django
Примечание: если ты используешь Chromebook, пропусти эту главу, но выполни инструкции по настройке для Chromebook
Примечание: если ты уже выполнила установку — можешь пропустить эту часть и сразу перейти к следующей главе!
Отдельные части этой главы основаны на учебных пособиях Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).
Отдельные части этой главы основаны на учебном пособии django-marcador, лицензированном под Creative Commons Attribution-ShareAlike 4.0 International License. Руководство django-marcador защищено авторским правом Markus Zapke-Gründemann et al.
Виртуальное окружение
Перед установкой Django мы попросим тебя установить крайне полезный инструмент, который поможет тебе содержать среду разработки в чистоте. Можно пропустить этот шаг, но мы очень советуем этого не делать. Использование лучших рекомендаций с самого начала убережёт от многих проблем в будущем!
Итак, давай создадим виртуальное окружение (оно также называется virtualenv). Virtualenv будет изолировать настройки Python/Django для каждого отдельного проекта. Это значит, что изменения одного сайта не затронут другие сайты, которые ты разрабатываешь. Удобно, правда?
Всё, что тебе нужно сделать — найти директорию, в которой мы создадим virtualenv ; домашний каталог вполне подойдёт. Для Windows адрес будет выглядеть так: C:\Users\Name (где Name — твоё имя пользователя).
Примечание: Если ты работаешь в Windows, удостоверься, что в названии директории нет специальных символов или символов с диакритическими знаками; если в твоём имени пользователя есть такие символы, выбери другую директорию, например, C:\djangogirls .
Мы будем использовать отдельную директорию djangogirls в домашнем каталоге:
$ mkdir djangogirls $ cd djangogirls
Мы создадим виртуальное окружение под именем myvenv . В общем случае команда будет выглядеть так:
$ python3 -m venv myvenv
Виртуальное окружение: Windows
Чтобы создать новое virtualenv , тебе нужно открыть командную строку и набрать python -m venv myvenv . Это будет выглядеть так:
C:\Users\Name\djangogirls> python -m venv myvenv
Здесь myvenv — имя твоего virtualenv . Ты можешь выбрать другое имя, но используй только строчные буквы, без пробелов и специальных символов. Имя виртуального окружения выбирай покороче — тебе придётся часто его набирать!
Виртуальное окружение: Linux и OS X
В Linux и OS X достаточно набрать python3 -m venv myvenv , чтобы создать virtualenv :
$ python3 -m venv myvenv
myvenv — имя виртуального окружения virtualenv . Можешь выбрать другое имя, но используй только строчные буквы и никаких пробелов. Имя виртуального окружения лучше выбирать покороче — набирать его предстоит не раз!
Примечание: В некоторых версиях Debian/Ubuntu может произойти следующая ошибка:
command-line
The virtual environment was not created successfully because ensurepip is not available. On Debian/Ubuntu systems, you need to install the python3-venv package using the following command. apt install python3-venv You may need to use sudo with that command. After installing the python3-venv package, recreate your virtual environment.
В таком случае следуй приведённым инструкциям и установи пакет python3-venv :
command-line
$ sudo apt install python3-venv
Примечание: В некоторых версиях Debian/Ubuntu при таком способе создания виртуального окружения ты можешь получить такую ошибку:
command-line
Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1
Чтобы обойти её, используй команду virtualenv .
command-line
$ sudo apt install python-virtualenv $ virtualenv --python=python3.8 myvenv
Примечание: Если ты получаешь следующую ошибку
command-line
E: Unable to locate package python3-venv
то запусти команду:
command-line
sudo apt install python3.8-venv
Работаем с virtualenv
Указанная выше команда создаст директорию myvenv (или другую, в зависимости от выбранного тобой имени), которая будет содержать виртуальное окружение (по сути — набор файлов и папок).
Работаем с virtualenv: Windows
Запусти виртуальное окружение, выполнив:
C:\Users\Name\djangogirls> myvenv\Scripts\activate
ПРИМЕЧАНИЕ: в Windows 10 при работе в Windows PowerShell ты можешь получить ошибку вида execution of scripts is disabled on this system . В этом случае открой ещё одно окно Windows PowerShell, выбрав опцию «Запустить от имени Администратора». Затем перед использованием виртуального окружения попробуй запустить следующую команду:
command-line
C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned Execution Policy Change The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "N"): A
Работаем с virtualenv: Linux и OS X
Запусти виртуальное окружение, выполнив:
$ source myvenv/bin/activate
Не забудь поменять myvenv на выбранное тобой имя для virtualenv !
ПРИМЕЧАНИЕ: иногда команда source может быть недоступна. В таком случае используй следующий метод:
command-line
$ . myvenv/bin/activate
Ты поймёшь, что virtualenv запущено, когда увидишь префикс (myvenv) в начале приглашения командной строки.
При работе с виртуальным окружением команда python будет автоматически обращаться к правильной версии языка, так что ты можешь использовать просто python вместо python3 .
Отлично, теперь мы будем хранить все важные зависимости в одном месте. Наконец можно установить Django!
Установка Django
После запуска virtualenv ты можешь установить Django.
Перед этим мы должны удостовериться, что у тебя установлена последняя версия pip — программы, которую мы используем для установки Django.
(myvenv) ~$ python3 -m pip install --upgrade pip
Установка библиотек через указание требований
Файл с требованиями (requirements) хранит список зависимостей, которые нужно установить с помощью pip install :
Для начала создай файл requirements.txt внутри директории djangogirls/ , используя текстовый редактор, который ты установила ранее. Просто создай в редакторе новый файл, а затем сохрани его под именем requirements.txt в директории djangogirls/ . После этого твоя директория будет выглядеть так:
djangogirls └───requirements.txt
В файл djangogirls/requirements.txt нужно добавить такой текст:
Django~=3.2.10
Теперь выполни команду pip install -r requirements.txt , чтобы установить Django.
(myvenv) ~$ pip install -r requirements.txt Collecting Django~=3.2.10 (from -r requirements.txt (line 1)) Downloading Django-3.2.10-py3-none-any.whl (7.1MB) Installing collected packages: Django Successfully installed Django-3.2.10
Установка Django: Windows
Если при запуске pip в Windows ты получаешь сообщение об ошибке, проверь, что путь к директории с проектом не содержит пробелов или специальных символов ( C:\Users\User Name\djangogirls ). Если проблема в этом, то, пожалуйста, перенеси свой проект в другое место, адрес которого не будет содержать пробелов и специальных символов (предлагаем C:\djangogirls ). Создай новое виртуальное окружение в новой директории, после этого удали старое и попробуй запустить команды выше заново (перемещение виртуального окружения не сработает, поскольку в нём используются абсолютные пути).
Установка Django: Windows 8 и Windows 10
При попытке установки Django твоя командная строка может зависнуть. Если это произошло, вместо приведённой выше команды используй:
command-line
C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
Установка Django: Linux
При возникновении ошибки при вызове pip под Ubuntu 12.04, пожалуйста, запусти `python -m pip install -U —force-reinstall pip`, чтобы исправить установку pip в virtualenv.
Вот и всё! Теперь ты (наконец-то) готова создать своё Django-приложение!
Как установить Django на хостинг: пошаговая инструкция
Если вы задумываетесь о разработке нового сайта с широким функционалом, будет полезно знать, как установить Django на хостинг. Это один из самых популярных фреймворков, который существенно упрощает создание различных функциональных элементов, внедрение панели управления или использование инструментов загрузки файлов.
Что такое Django и зачем он нужен
Чтобы упростить и ускорить процесс создания сайта, разработчики используют фреймворки, которые выполняют функцию каркаса, которые задают структуру. В них уже предусмотрен набор правил и стандартных инструментов, за счёт чего удаётся объединить разные компоненты большого программного проекта, применяя готовые решения.
Django — это бесплатный инструмент, предназначенный специально для разработки веб- приложений на Python . Работает он на серверной стороне, а пользоваться им удобно опытным специалистам и новичкам, так как залить Django сайт на хостинг может быть актуально для разного масштаба.
С помощью Django можно разрабатывать программное обеспечение, обеспечив абсолютную изоляцию отдельных модулей. То есть удаётся их редактировать обособленно друг от друга, не нарушая их функции в случае применения изменений. Такой подход предполагает уменьшение дублирования данных (DRY). Это делает код более простым, ускоряет процесс создания сайта и окупается в долгосрочной перспективе.
(2).png)
Платформа Django актуальная в трёх случаях.
- Вы будете использовать исключительно свободное программное обеспечение.
- Вам нужно быстро развернуть сайт или только внести изменения.
- Вам важно обеспечить совместимость сайта с другими своими проектами.
Нужно учитывать, что развернуть проект Django на хостинге можно только при использовании основного домена. Этот фреймворк не подходит для автоподдоменов, но можно использовать поддомен как самостоятельный сайт. Кроме того, управлять им можно только с помощью CMS ISPmanager.
Как поставить Django на хостинг
Сначала надо зайти в панель управления хостингом в личном кабинете. Найдите раздел «Сайты». Выберете нужный домен и нажмите «Изменить».
Теперь откройте вкладку «Дополнительные возможности». Поставьте галки напротив пунктов CGI-скрипты и Python. Также нужно выбрать версию Python. В нашем примере это 3.7.0.
(2).png)
Следующий шаг – подключение к хостингу по безопасному соединению SSH . Далее управление выполняется с помощью команд.
cd ~ — переход в каталог пользователя.
pwd – проверка каталога.
(1).png)
В данном случае u0000006 – это логин услуги, у вас он может быть другим.
Когда выполняется установка Django на сервер, нужно создать виртуальное окружение и задать ему имя. Так называется предоставленная сервером среда, где будет размещён сайт с возможностью публичного запуска и доступа. Сюда входит 6 компонентов.
- Аппаратное обеспечение.
- Операционная система.
- Языки программирования и библиотеки.
- Веб-сервер.
- Сервер приложений для передачи запросов.
- База данных, которая содержит необходимую информацию для работы веб-ресурса.
Поскольку виртуальное окружение создаётся для Python, нужно убедиться, что версия совпадает с той, что вы указывали ранее в настройках. Для этого введите команду
ls -la /opt/python/*/bin/python
В ответ система представит все доступные версии.
Теперь можно создавать виртуальное окружение. Введите команду.
/opt/python/python-3.7.6/bin/python -m venv djangoenv
В примере python-3.7.6 — это выбранная версия Python, а «djangoenv» — заданное название виртуального окружения.
Виртуальное окружение нужно активировать.
если слева от команды появилось название, всё сделано правильно.
Дальнейшая установка Django на хостинг требует обновить pip, а также поставить пакеты Django и mysqlclient. Команда выглядит довольно массивно.
pip install —upgrade pip && pip install django && CFLAGS=»-std=c99″ pip install mysqlclient
Теперь можно зайти в корневой каталог.
cd www/ [название каталога]/
Перед тем как загрузить Django проект на хостинг, удалите из каталога веб-ресурса существующие файлы и папки. После этого создайте новый проект.
django-admin startproject [название проекта]
Открываем его настройки.
vim [название проекта]/ [название проекта]/settings.py
Вы увидите параметр ALLOWED_HOSTS = []. В скобках нужно указать домен и его псевдонимы, заключив их в одинарные кавычки.
(1).png)
Теперь смотрим следующий блок DATABASES. Здесь нужно прописать данные для подключения к БД.
(1).png)
Обратите внимание на несколько значений в данном примере.
u1234567_database — название базы данных,
u1234567_username — имя пользователя БД,
Переходим к блоку STATIC_URL. Под ним нужно добавить ещё один.
Нажмите клавишу Esc. Так вы вернётесь в командный режим и сможете продолжить управление. Введите следующую команду.
Теперь создаём каталог со статическими файлами.
python [название_проекта]/manage.py collectstatic
В ответ система выдаст сообщение с указанием числа файлов.
Далее нужно выполнить миграцию в MySQL .
python [название_проекта]/manage.py migrate
В корневой папке создаём конфигурационный файл.
vim /var/www/[логин услуги хостинга]/data/www/[корневая папка сайта]/passenger_wsgi.py
В конфигурационный файл нужно внести изменения. Впишите следующий текст с корректным указанием папок, проектов, путей к ним и других параметров.
sys.path.insert(0, ‘/var/www/[логин услуги хостинга]/data/www/[корневая папка сайта]/ название проекта)
sys.path.insert(1, ‘/var/www/[логин услуги хостинга]/djangoenv/lib/[версия Python]/site-packages’)
os.environ[‘DJANGO_SETTINGS_MODULE’] = ‘название проекта’
from django.core.wsgi import get_wsgi_application
Нажмите Esc для возвращения в командный режим. Сохраните изменения с помощью команды «:wq». Нажмите Enter.
Как перезапустить проект на Django
После того как сайт на Django выложить на хостинг удалось, можно посмотреть изменения в файлах проекта. Для этого в его корневой директории создайте файл .restart-app: через менеджер файлов в панели управления.
(1).png)
Откроется форма, где нужно задать имя и тип (выбирайте «файл» их выпадающего списка). Нажмите кнопку «ОК».
В результате проект будет перезапущен, а сам файл удалится из системы.
Как запустить сайт на Django без ошибок: с какими трудностями сталкиваются пользователи
Иногда ошибки возникают при создании каталога со статическими файлами. В этом случае нужно проверить файл settings.py. Возможно, некорректно указано название домена, нет одинарных кавычек.
Проблема может быть связана с разными окружениями, так как перенос Django проекта на хостинг затрагивает несколько сред: локальную, dev, ci, qa и другие. Каждая из них имеет свои настройки. Например, значение DEBUG = True. В них придётся внимательно разобраться.
Некоторые пользователи сталкиваются с ошибкой 500. Чаще всего она возникает, если неправильно указан путь к папкам. Корректный путь можно узнать с помощью команды pwd.
Заключение
В этой статье мы подробно рассмотрели, как запустить Django на хостинге и исправить ошибки в случае необходимости. Этот высокоуровневый веб-фреймворк характеризуется внушительным комплектом компонентов, помогающих ускорить разработку сайта. Однако для работы с ним пользователю требуются профильные знания в сфере информационных технологий. При возникновении трудностей целесообразно обращаться в техподдержку или найти нужную документацию в крупном сообществе разработчиков, так как Django пользуется популярностью в IT-среде.
How to install Django¶
This document will get you up and running with Django.
Install Python¶
Django is a Python web framework. See What Python version can I use with Django? for details.
Get the latest version of Python at https://www.python.org/downloads/ or with your operating system’s package manager.
Python on Windows
If you are just starting with Django and using Windows, you may find How to install Django on Windows useful.
Install Apache and mod_wsgi ¶
If you just want to experiment with Django, skip ahead to the next section; Django includes a lightweight web server you can use for testing, so you won’t need to set up Apache until you’re ready to deploy Django in production.
If you want to use Django on a production site, use Apache with mod_wsgi. mod_wsgi operates in one of two modes: embedded mode or daemon mode. In embedded mode, mod_wsgi is similar to mod_perl – it embeds Python within Apache and loads Python code into memory when the server starts. Code stays in memory throughout the life of an Apache process, which leads to significant performance gains over other server arrangements. In daemon mode, mod_wsgi spawns an independent daemon process that handles requests. The daemon process can run as a different user than the web server, possibly leading to improved security. The daemon process can be restarted without restarting the entire Apache web server, possibly making refreshing your codebase more seamless. Consult the mod_wsgi documentation to determine which mode is right for your setup. Make sure you have Apache installed with the mod_wsgi module activated. Django will work with any version of Apache that supports mod_wsgi.
See How to use Django with mod_wsgi for information on how to configure mod_wsgi once you have it installed.
If you can’t use mod_wsgi for some reason, fear not: Django supports many other deployment options. One is uWSGI ; it works very well with nginx. Additionally, Django follows the WSGI spec ( PEP 3333), which allows it to run on a variety of server platforms.
Get your database running¶
If you plan to use Django’s database API functionality, you’ll need to make sure a database server is running. Django supports many different database servers and is officially supported with PostgreSQL, MariaDB, MySQL, Oracle and SQLite.
If you are developing a small project or something you don’t plan to deploy in a production environment, SQLite is generally the best option as it doesn’t require running a separate server. However, SQLite has many differences from other databases, so if you are working on something substantial, it’s recommended to develop with the same database that you plan on using in production.
In addition to the officially supported databases, there are backends provided by 3rd parties that allow you to use other databases with Django.
In addition to a database backend, you’ll need to make sure your Python database bindings are installed.
- If you’re using PostgreSQL, you’ll need the psycopg or psycopg2 package. Refer to the PostgreSQL notes for further details.
- If you’re using MySQL or MariaDB, you’ll need a DB API driver like mysqlclient . See notes for the MySQL backend for details.
- If you’re using SQLite you might want to read the SQLite backend notes .
- If you’re using Oracle, you’ll need a copy of cx_Oracle, but please read the notes for the Oracle backend for details regarding supported versions of both Oracle and cx_Oracle .
- If you’re using an unofficial 3rd party backend, please consult the documentation provided for any additional requirements.
If you plan to use Django’s manage.py migrate command to automatically create database tables for your models (after first installing Django and creating a project), you’ll need to ensure that Django has permission to create and alter tables in the database you’re using; if you plan to manually create the tables, you can grant Django SELECT , INSERT , UPDATE and DELETE permissions. After creating a database user with these permissions, you’ll specify the details in your project’s settings file, see DATABASES for details.
If you’re using Django’s testing framework to test database queries, Django will need permission to create a test database.
Install the Django code¶
Installation instructions are slightly different depending on whether you’re installing a distribution-specific package, downloading the latest official release, or fetching the latest development version.
Installing an official release with pip ¶
This is the recommended way to install Django.
- Install pip. The easiest is to use the standalone pip installer. If your distribution already has pip installed, you might need to update it if it’s outdated. If it’s outdated, you’ll know because installation won’t work.
- Take a look at venv . This tool provides isolated Python environments, which are more practical than installing packages systemwide. It also allows installing packages without administrator privileges. The contributing tutorial walks through how to create a virtual environment.
- After you’ve created and activated a virtual environment, enter the command:
/ 
$ python -m pip install Django
. \> py -m pip install Django
Installing a distribution-specific package¶
Check the distribution specific notes to see if your platform/distribution provides official Django packages/installers. Distribution-provided packages will typically allow for automatic installation of dependencies and supported upgrade paths; however, these packages will rarely contain the latest release of Django.
Installing the development version¶
Tracking Django development
If you decide to use the latest development version of Django, you’ll want to pay close attention to the development timeline, and you’ll want to keep an eye on the release notes for the upcoming release . This will help you stay on top of any new features you might want to use, as well as any changes you’ll need to make to your code when updating your copy of Django. (For stable releases, any necessary changes are documented in the release notes.)
If you’d like to be able to update your Django code occasionally with the latest bug fixes and improvements, follow these instructions:
- Make sure that you have Git installed and that you can run its commands from a shell. (Enter git help at a shell prompt to test this.)
- Check out Django’s main development branch like so:
/ 
$ git clone https://github.com/django/django.git
. \> git clone https://github.com/django/django.git
/ 
$ python -m pip install -e django/
. \> py -m pip install -e django\
When you want to update your copy of the Django source code, run the command git pull from within the django directory. When you do this, Git will download any changes.
Additional Information
Support Django!
Contents
- How to install Django
- Install Python
- Install Apache and mod_wsgi
- Get your database running
- Install the Django code
- Installing an official release with pip
- Installing a distribution-specific package
- Installing the development version
Browse
- Prev: Using Django
- Next: Models and databases
- Table of contents
- General Index
- Python Module Index
You are here:
- Django 4.2 documentation
- Using Django
- How to install Django
Getting help
FAQ Try the FAQ — it’s got answers to many common questions. Index, Module Index, or Table of Contents Handy when looking for specific information. django-users mailing list Search for information in the archives of the django-users mailing list, or post a question. #django IRC channel Ask a question in the #django IRC channel, or search the IRC logs to see if it’s been asked before. Django Discord Server Join the Django Discord Community. Official Django Forum Join the community on the Django Forum. Ticket tracker Report bugs with Django or Django documentation in our ticket tracker.
Download:
Offline (Django 4.2): HTML | PDF | ePub
Provided by Read the Docs.
- Using Django