Wafer supports Django 2.0-3.0 and Python 3.6 onwards.
In addition to Django, wafer has some requirements on external
libraries. They’re listed in
Basic Dev install¶
- Install all the dependencies
pip install -r requirements.txt
- Create the initial database schema
- If you don’t have one yet, create a superuser with
- Wafer uses npm to manage front-end dependencies
- Make sure you have a recent version of Node.js installed that
npm installto install all dependencies, which also copies them to
- Make sure you have a recent version of Node.js installed that includes
- Wafer uses the Django caching infrastructure in several places, so
the cache table needs to be created using
- Create the default ‘Page Editors’, ‘Talk Mentors’, and ‘Talk
Reviewers’ groups using
- Log in and configure the Site:
- The domain will be used as the base for emails sent during registration.
- The name will be the conference’s name.
- By default, wafer assumes that the site will be accessible over SSL,
so the registration emails will use an ‘https’ prefix. If this
is not the case, override the
- Ensure the permissions on the
MEDIA_ROOTdirectory are correctly set so the webserver can create new files there. This location is used for files uploaded for pages and sponsor information.
- Have a fun conference.
Recommended production setup¶
Create a new Django app, in your own VCS repository. Add wafer (probably pinned) as a requirement.
from wafer.settings import * TIME_ZONE = 'Africa/Johannesburg' ...
You’ll want to include wafer’s default values for some settings, e.g.
INSTALLED_APPS, rather than completely overriding them. See Settings for the wafer-specific settings.
Override templates as necessary, by putting your own templates directory early in
And then continue with the basic instructions above.