PyCon 2014 website being built by Caktus Consulting Group, based on symposion.

Rather than use this as the basis for your conference site directly, you should instead look at which was designed for reuse.

PyCon 2014 is built on top of Pinax Symposion but may have customizations that will just make things more difficult for you.

Installation instructions are in this README. There's more documentation at

To get running locally

  • Create a new virtualenv and activate it:

    $ virtualenv env/pycon
    $ . env/pycon/bin/activate
  • Install the requirements for running and testing locally:

    $ pip install -r requirements/dev.txt

    (For production, install -r requirements/project.txt).

  • Copy pycon/settings/ to pycon/settings/

  • Edit pycon/settings/ according to the comments. Note that you will have to edit it; by default everything there is commented out.

  • Setup the database:

    $ ./
  • Create a user account:

    $ ./ createsuperuser
  • If you have ssh access to the staging server, copy the database and media:

    $ fab staging get_db_dump:pycon2014
    $ fab staging get_media

    Change pycon2014 in that first command to the name of your local database.

  • Run local server:

    python runserver

For production

  • Start with instructions above, except:

    • Install requirements from requirements/project.txt instead of requirements/dev.txt
    • Stop when you get to Run local server
  • Edit pycon/settings/ to make sure DEBUG=False.

  • Add an appropriate ALLOWED_HOSTS setting (

  • Install lessc (Go to and search for "Server-side usage")

  • Pre-compress everything by running:

    python compress --force

    That will write compressed css and js files under site_media

  • Gather the static files:

    python collectstatic --noinput
  • Arrange to serve the site_media directory as /2014/site_media/whatever. E.g. site_media/foo.html would be at /2014/site_media/foo.html.

  • Arrange to serve the wsgi application in symposion/ at /, running with the same virtualenv (or equivalent). It will only handle URLs starting with /2014 though, so you don't have to pass it any other requests.

To run tests

python test

More documentation

There's more documentation under docs/.