Getting started¶
Wagtail is built on the Django web framework, so this document assumes you’ve already got the essentials installed. But if not, those essentials are:
We’d also recommend Virtualenv, which provides isolated Python environments:
Before we install Wagtail we should install Pillow for image manipulation. Before you run pip install Pillow
note that most platforms require you install additional libraries first: Platform-specific installation instructions
With the above installed, the quickest way to install Wagtail is:
pip install wagtail
(sudo
may be required if installing system-wide or without virtualenv)
Once installed, Wagtail provides a command similar to Django’s django-admin startproject
which stubs out a new site/project:
wagtail start mysite
This will create a new folder mysite
, based on a template containing all you need to get started. More information on that template is available here.
Inside your mysite
folder, we now just run the setup steps necessary for any Django project:
pip install -r requirements.txt
./manage.py migrate
./manage.py createsuperuser
./manage.py runserver
Your site is now accessible at http://localhost:8000
, with the admin backend available at http://localhost:8000/admin/
.
There are a few optional packages which are not installed by default but are recommended to improve performance or add features to Wagtail, including: