:snake: Hiss

An open-source, hackathon registration system. :school:

:question: Questions

If you have questions, we might've answered them already on the wiki! Check it out.

:computer: Running Locally

Local Development

For local development, we highly encourage using Docker Compose.

After Docker Compose is installed, there are just a few steps left for first-time setup:

docker-compose up -d
docker-compose exec db su postgres # Currently on host, moving into container
psql # Currently in container, moving into PostgreSQL prompt 

Now that you're in the PostgreSQL prompt, just run


This will create the database for you, and you're done with setup!

exit # In the PostgreSQL prompt, moving to container
exit # In the container, moving to the host

Now that you're on the host machine, just run the following:

docker-compose run web python3 migrate --run-syncdb
docker-compose run web python3 createsuperuser # Enter details for an admin user to access the admin panel.

You're all set! Just run docker-compose up and you're good to go!

Mimic Production

To mimic a real production environment, a file has been included in the repository for you to use.

This file is set up on the assumption that you are using Mailgun as your team's email provider.

To use it, simply replace the values in with the values you need, and run

docker-compose -f docker-compose.yml -f up