# 빠른 설치

```{note}
이 지침은 가상 환경과 [Django 웹 프레임워크](https://www.djangoproject.com/)에 대한 친숙함을 전제로 합니다.
자세한 지침은 [](tutorial)를 참조하십시오.
기존 Django 프로젝트에 Wagtail을 추가하려면 [](integrating_into_django)를 참조하십시오.
```

## 설치에 필요한 종속성

- [Python 3](https://www.python.org/downloads/).
- **libjpeg** 및 **zlib**, Django의 **Pillow** 라이브러리에 필요한 라이브러리입니다.
  Pillow의 [플랫폼별 설치 지침](https://pillow.readthedocs.io/en/stable/installation/building-from-source.html#external-libraries)을 참조하십시오.

## Wagtail 설치

선택한 가상 환경에서 다음 명령을 실행합니다:

```sh
pip install wagtail
```

설치되면 Wagtail은 새 프로젝트를 생성하는 `wagtail start` 명령을 제공합니다:

```sh
wagtail start mysite
```

명령을 실행하면 `mysite` 라는 새 폴더가 생성됩니다. 이 폴더는 시작하는 데 필요한 모든 것을 포함하는 템플릿입니다.
이 템플릿에 대한 자세한 정보는 [프로젝트 템플릿 참조](/reference/project_template)에서 확인할 수 있습니다.

`mysite` 폴더 안에서 모든 Django 프로젝트에 필요한 설정 단계를 실행합니다:

```sh
pip install -r requirements.txt
python manage.py migrate
python manage.py createsuperuser
python manage.py runserver
```

이제 사이트는 `http://localhost:8000` 에서 접근할 수 있으며, 관리 백엔드는 `http://localhost:8000/admin/` 에서 사용할 수 있습니다.

이는 새로운 독립형 Wagtail 프로젝트를 설정합니다.
대신 Wagtail을 기존 Django 프로젝트에 추가하려면 [Wagtail을 Django 프로젝트에 통합하기](/getting_started/integrating_into_django)를 참조하십시오.

기본적으로 설치되지 않는 몇 가지 선택적 패키지가 있습니다. Wagtail의 성능을 향상시키거나 기능을 추가하기 위해 설치할 수 있습니다. 이러한 선택적 패키지에는 다음이 포함됩니다:

- [Elasticsearch](wagtailsearch_backends_elasticsearch)
- [Feature Detection](image_feature_detection)

(common_installation_issues)=

## 일반적인 빠른 설치 문제

### Python이 `path` 에 없음

```sh
python
> command not found: python
```

자세한 내용은 [Python을 경로에 추가하는 방법](https://realpython.com/add-python-to-path/)에 대한 이 가이드를 참조하십시오.

### python3 사용 불가

```sh
python3 -m pip install --upgrade pip
> command not found: python3
```

이 오류가 발생하면 [`python3` 를 `py` 로 바꿀 수 있습니다](inv:python#faq-run-program-under-windows).