Skip to content


Repository files navigation


Travis CI build status Wafer documentation Translation status

A wafer-thin web application for running small conferences. Built using Django.

Licensed under the ISC License.


Available on

Supported Django versions

Wafer supports Django 3.2 and Django 4.0 - 4.2.


  1. wafer can be installed either from pypi (pip install wafer) or from the github repository.

  2. If installing from github, pip install -r requirements.txt should install all the required python and django dependencies.

  3. Wafer uses npm to manage front-end dependencies

    • Make sure you have a recent version of Node.js installed that includes npm.
    • Run npm install to install all dependencies, which also copies them to wafer/static/vendor.
  4. Install the wafer applications migrate

  5. If you don't have one yet, create a superuser with createsuperuser.

  6. Examine the file and create a file overriding the defaults as required.


    If you add extensions to MARKITUP_FILTER or WAFER_PAGE_MARKITUP_FILTER, be sure to install the appropriate python packages as well.

  7. Wafer uses the Django caching infrastructure in several places, so the cache table needs to be created using createcachetable.

  8. Create the default 'Page Editors', 'Talk Mentors' and other useful groups using wafer_add_default_groups.

  9. Log in and configure the Site:

    • The domain will be used as the base for e-mails sent during registration.
    • The name will be the conference's name.
  10. Have a fun conference.

Running wafer

To run a local server for development and testing, use the standard Django runserver, after doing the installation.

For running the server in production, please see the Django documentation on the various possible approaches.


  • Support for adding and editing sponsors via Django admin.
  • Schedule can be created and updated via Django admin.
  • Pages for static content, news and so forth can be handled via Django admin.
    • Can be delegated to the 'Page Editors' group.
    • Pages can be updated via the web interface.
  • Talk submissions, review and acceptance.
  • Generate a static version of the site for archival.


Translations for wafer are managed at

Selenium tests

wafer includes a small set of selenium tests to test various bits of javascript used in the site (mostly in the schedule editor).

To run the tests, you will need to install selenium - pip install selenium and also run rpm install to install the required javascript dependencies.

The tests can be run using the selenium tag, or using the individual browser tags (currently firefox and chrome).