---
title: "Jak zainstalować Django"
version: 2.0
locale: pl
source: https://docs.djangoproject.com/pl/2.0/topics/install/
canonical: https://djangodocs.dev/pl/2.0/topics/install/
---
# Jak zainstalować Django

Ten dokument pomoże ci rozpocząć pracę z Django.

## Instalacja Pythona

Django jest pythonowym web-frameworkiem. Szczegóły znajdziesz w [Której wersji Pythona mogę użyć z Django?](/pl/2.0/faq/install/#faq-python-version-support).

Pobierz najnowszą wersję Pythona z <https://www.python.org/downloads/> lub przez menadżer pakietów twojego systemu operacyjnego.

> **Django na Jythonie**
>
> [Jython](http://www.jython.org/) (a Python implementation for the Java platform) is not compatible
> with Python 3, so Django ≥ 2.0 cannot run on Jython.

> **Python w systemie Windows**
>
> Jeśli dopiero zaczynasz pracę z Django i używasz systemu Windows, przydatny może być artykuł [How to install Django on Windows](/pl/2.0/howto/windows/).

## Zainstaluj Apache i `mod_wsgi`

Jeśli chcesz tylko poeksperymentować z Django, przeskocz od razu do następnej sekcji; Django zawiera lekki web serwer, którego możesz używać do testowania, więc nie musisz uruchamiać Apache’a dopóki nie będziesz gotowy na deployment Django w produkcji.

Jeśli chcesz użyć Django w witrynie produkcyjnej, użyj [Apache’a](https://httpd.apache.org/) z [mod\_wsgi](http://www.modwsgi.org/). mod\_wsgi działa w jednym z dwóch trybów: trybie osadzonym lub trybie demona. W trybie osadzonym, mod\_wsgi jest podobny do mod\_perl – osadza Pythona w Apache’u i ładuje kod Pythona do pamięci, gdy serwer jest uruchamiany. Kod pozostaje w pamięci w czasie życia procesu Apache’a, co prowadzi do znaczących zysków wydajności względem innych ustawień serwera. W trybie demona mod\_wsgi tworzy niezależny proces demona, który obsługuje żądania. Proces demona może działać jako inny użytkownik od użytkownika serwera Web, co może prowadzić do większego bezpieczeństwa. Proces demona może zostać zrestartowany bez restartowania całego web-serwera Apache, prawdopodobnie czyniąc odświeżanie twojej bazy kodu bardziej płynnym. Porównaj dokumentację mod\_wsgi, aby określić, który tryb będzie właściwy dla twojej konfiguracji. Upewnij się, że masz zainstalowanego Apache’a i aktywowany moduł mod\_wsgi. Django będzie działać z każdą wersją Apache’a, która obsługuje mod\_wsgi.

W [Jak używać Django z mod\_wsgi](/pl/2.0/howto/deployment/wsgi/modwsgi/) znajdziesz informacje jak skonfigurować mod\_wsgi, kiedy masz je już zainstalowane.

Jeśli z jakiegoś powodu nie możesz użyć mod\_wsgi, nie bój się: Django wspiera wiele innych możliwości deploymentu. Jedną z nich jest [uWSGI](/pl/2.0/howto/deployment/wsgi/uwsgi/); działa bardzo dobrze z [nginx](https://nginx.org/). Dodatkowo Django realizuje specyfikację WSGI ([**PEP 3333**](https://peps.python.org/pep-3333/)), co pozwala mu być uruchamianym na różnorodnych platformach serwerowych.

## Uruchamianie bazy danych

Jeśli planujesz użyć funkcjonalności API bazy danych Django, powinieneś upewnić się, że serwer bazy danych działa. Django wspiera wiele różnych serwerów baz danych i jest oficjalnie wspierane z bazami danych [PostgreSQL](https://www.postgresql.org/), [MySQL](https://www.mysql.com/), [Oracle](https://www.oracle.com/) i [SQLite](https://www.sqlite.org/).

Jeśli rozwijasz prosty projekt lub coś, czego nie planujesz uruchamiać w środowisku produkcyjnym, ogólnie najprostszym rozwiązaniem jest SQLite, jako że nie wymaga uruchamiania osobnego serwera. Jednakże SQLite bardzo różni się od innych baz danych, więc jeśli pracujesz nad czymś ważnym, zalecane jest pracować z tą samą bazą danych, którą planujesz użyć na produkcji.

Oprócz oficjalnie wspieranych baz danych, istnieją [zewnętrzne backendy](/pl/2.0/ref/databases/#third-party-notes), które umożliwiają pracę z innymi bazami danych z Django.

W uzupełnieniu do backendu bazy danych, musisz upewnić się, że masz zainstalowane wiązania bazodanowe Pythona.

- Jeśli używasz PostgreSQL-a, będziesz potrzebował pakietu [psycopg2](http://initd.org/psycopg/). W [uwagach na temat PostgreSQL-a](/pl/2.0/ref/databases/#postgresql-notes) znajdziesz więcej szczegółów.
- Jeśli używasz MySQL-a, potrzebujesz [sterownika API bazy danych](/pl/2.0/ref/databases/#mysql-db-api-drivers), takiego jak `mysqlclient`. W [uwagach na temat backendu MySQL](/pl/2.0/ref/databases/#mysql-notes) znajdziesz szczegóły.
- Jeśli używasz SQLite’a, być może przydzą ci się [uwagi na temat backendu SQLite](/pl/2.0/ref/databases/#sqlite-notes).
- Jeśli używasz Oracle’a, będziesz potrzebować kopii [cx\_Oracle](https://oracle.github.io/python-cx_Oracle/), lecz prosimy przeczytaj [uwagi na temat backendu Oracle](/pl/2.0/ref/databases/#oracle-notes), gdzie znajdziesz więcej szczegółów dotyczących wspieranych wersji zarówno Oracle’a jak i `cx_Oracle'a`.
- Jeśli używasz nieoficjalnego zewnętrznego backendu, prosimy powołaj się na dokumentację dostarczoną przez te zewnętrzne biblioteki.

Jeśli planujesz używać komendy `manage.py migrate` Django do automatycznego tworzenia tabel w bazie danych dla swoich modeli (po zainstalowaniu najpierw Django i stworzeniu projektu), musisz upewnić się, że Django ma uprawnienia do tworzenia i zmiany schematu tabel w bazie danych, którą używasz; jeśli planujesz ręcznie stworzyć tabele, możesz po prostu nadać Django uprawnienia `SELECT`, `INSERT`, `UPDATE` i `DELETE`. Po stworzeniu użytkownika bazy danych z tymi uprawnieniami, podasz szczegóły w pliku ustawień swojego projektu. Szczegóły znajdziesz w [`DATABASES`](/pl/2.0/ref/settings/#std-setting-DATABASES).

Jeśli używasz [frameworku testów](/pl/2.0/topics/testing/) Django, aby testować kwerendy do bazy danych, Django będzie potrzebować uprawnienia do stworzenia testowej bazy danych.

## Usuń wszystkie stare wersje Django

Jeśli upgrade’ujesz swoją instalację Django z wcześniejszej wersji, musisz odinstalować stare wersje Django przed zainstalowaniem nowej wersji.

Jeśli zainstalowałeś wcześniej Django używając pakietu [pip](https://pip.pypa.io/) lub `easy_install`, zainstalowanie znów z pakietem [pip](https://pip.pypa.io/) lub `easy_install` automatycznie zajmie się starą wersją, więc nie musisz tego robić własnoręcznie.

Jeśli zainstalowałeś wcześniej Django za pomocą `python setup.py install`, odinstalowanie polega po prostu na usunięciu katalogu `django` z twoich pythonowych `site-packages`. Aby znaleźć katalog, który musisz usunąć, możesz uruchomić poniższe w swojej linii komend (nie w interaktywnej konsoli Pythona):

```console
$ python -c "import django; print(django.__path__)"
```

## Instalacja kodu Django

Instrukcje instalacji są nieco różne w zależności od tego, czy instalujesz pakiet dla dystrybucji, ściągasz najnowsze oficjalne wydanie, czy pobierasz najnowszą wersję deweloperską.

To proste, którykolwiek z tych sposobów wybierzesz.

### Instalacja oficjalnego wydania za pomocą `pip`

Jest to rekomendowany sposób instalacji Django.

1. Zainstaluj [pip](https://pip.pypa.io/). Najprostszym sposobem jest użycie [samodzielnego instalatora pip](https://pip.pypa.io/en/latest/installing/#installing-with-get-pip-py). Jeśli twoja dystrybucja ma już zainstalowanego `pipa`, możesz potrzebować go zaktualizować, jeśli jest przestarzały. Zorientujesz się, jeśli jest przestarzały, bo instalacja nie zadziała.
2. Take a look at [virtualenv](https://virtualenv.pypa.io/) and [virtualenvwrapper](https://virtualenvwrapper.readthedocs.io/en/latest/). These tools provide
   isolated Python environments, which are more practical than installing
   packages systemwide. They also allow installing packages without
   administrator privileges. The [contributing tutorial](/pl/2.0/intro/contributing/) walks through how to create a virtualenv.
3. Po stworzeniu i aktywacji środowiska wirtualnego, wpisz komendę `pip install Django` w linii komend.

### Instalacja pakietu w dystrybucji

Sprawdź w [uwagach do dystrybucji](/pl/2.0/misc/distributions/) czy twoja platforma/dystrybucja dostarcza oficjalne pakiety lub instalatory Django. Pakiety dostarczane przez dystrybucje zazwyczaj pozwalają na automatyczną instalację zależności i prostą ścieżkę upgrade’ów. Jednakże rzadko zawierają najnowsze wydanie Django.

### Instalacja wersji deweloperskiej

> **Śledzenie rozwoju Django**
>
> Jeśli zdecydujesz się na używanie najnowszej deweloperskiej wersji Django, powinieneś poświęcać uwagę [harmonogramowi dewelopmentu](https://code.djangoproject.com/timeline) i mieć oko na [informacje o nadchodzących wydaniach](/pl/2.0/releases/#development-release-notes). Pomoże ci to być na bieżąco z nowymi funkcjami, których możesz chcieć użyć, jak i z jakimikolwiek zmianami, które powinieneś zrobić w swoim kodzie, aktualizując swoją kopię Django. (Dla stabilnych wydań wszystkie niezbędne zmiany są udokumentowane w informacjach o wydaniach.)

Jeśli chciałbyś móc aktualizować kod Django od czasu do czasu, z najnowszymi poprawkami błędów i nowymi funkcjami, postępuj zgodnie z instrukcją:

1. Upewnij się, że masz zainstalowanego [Gita](https://git-scm.com/) i że możesz uruchamiać jego komendy z powłoki. (Wpisz `git help` w linię komend, aby to sprawdzić.)
2. Pobierz główną gałąź dewelopmentu Django w ten sposób:

   ```console
   $ git clone https://github.com/django/django.git
   ```

   W bieżącym katalogu powstanie katalog `django`.
3. Make sure that the Python interpreter can load Django’s code. The most
   convenient way to do this is to use [virtualenv](https://virtualenv.pypa.io/), [virtualenvwrapper](https://virtualenvwrapper.readthedocs.io/en/latest/), and
   [pip](https://pip.pypa.io/). The [contributing tutorial](/pl/2.0/intro/contributing/) walks through
   how to create a virtualenv.
4. Po stworzeniu i aktywacji virtualenva, uruchom następującą komendę:

   ```console
   $ pip install -e django/
   ```

   Spowoduje to, że kod Django będzie importowalny i komenda `django-admin` będzie dostępna. Innymi słowy wszystko gotowe!

Kiedy będziesz chciał zaktualizować swoją kopię kodu źródłowego Django, uruchom po prostu komendę `git pull` w katalogu `django`. Kiedy to zrobisz, Git automatycznie pobierze wszystkie zmiany.