A template repository to start a new wagtail site.
Requirements: Docker and Docker Compose (Docker Compose is included with Docker Desktop for Mac and Windows).
- On the repository front page, click the "Use this template" button and proceed with naming your repository and change other settings if you want. See screenshot:
-
Clone your repository and change to the directory in your terminal
-
Run
docker-compose up
-
This project is configured so that the container is built with everything necessary to build a new Wagtail site. On the first run, you will have a running container with no entry point. This is so that you can open a shell in your container and start your project. To open a shell, run
docker-compose exec web bash
. -
In your container shell, start your wagtail project:
wagtail start mysite /code
. -
In your container shell, run migrations:
python manage.py migrate
. -
Stop your container, change
docker-compose.yml
so that the linetail -F anything
is removed or commented out, and add in the line containingpython manage.py ...
:
- command: tail -F anything
+ command: python manage.py runserver 0.0.0.0:${DOCKER_DJANGO_PORT:-8000}
-
Start your container again
docker-compose up
-
Visit your app in your browser: http://localhost:8000/
-
Start developing your new Wagtail site on Docker!