For local development you only need to install Docker. Tested on version 23.0.2.
For Docker installation manuals check the following links:
- Ubuntu - install Docker engine using the apt repository and add user to
docker
group as described here so you can run Docker locally as a non-root user - Windows & Mac - you can use Docker Desktop, check out this manual for Windows and this for Mac
- Build an image
make build
- Run migrations
make migrate
[OPTIONAL] 2.2 Import content into Wagtail tables, so not to have empty pages
make default-content
- Run dev stack
make up
- You can stop the server by pressing Ctrl+C, optionally you can run
make down
if there are any hanging containers
In case you want to access admin page, either Django or Wagtail one, you need to create a superuser and log in with its credentials:
make create-user
The development server runs at the address http://0.0.0.0:8000/. Beta instance on fly.io runs on https://pycon-cz-beta.fly.dev/team/.
If you want to contribute, please run make lint
before pushing BE code to format it. This step will be automated in the future.
How to restart machine in fly.io if something gets stuck
fly machines list --app pycon-cz-beta-db
fly machines restart machine-id --app pycon-cz-beta-db