All of the code that runs on
PHP JavaScript HTML Ruby CSS PLpgSQL Other
Latest commit 0ac4059 Jan 21, 2017 @pedrosino pedrosino committed on GitHub Merge pull request #1115 from pedrosino/translation
Some fixes to translation. Build Status

This repository contains all of the code that runs on


  • Install Vagrant, which requires VirtualBox.
  • git clone - Clone this repo! (And navigate into it, cd
  • (cd WcaOnRails; bundle install) && pre-commit install - Set up git pre-commit hook. Optional, but very useful.
  • echo "{}" > WcaOnRails/app/views/regulations/wca-regulations.json - Set up an empty wca-regulations.json file to ensure api tests pass. Alternatively, you can build the Regulations locally by following this guide.

Run in Vagrant (easier and gets everything working)

  • vagrant up all - Once the VM finishes initializing (which can take some time), the website will be accessible at http://localhost:2331.
  • All emails will be accessible at http://localhost:2332.
  • Please take a look at this wiki page for more detailed informations about the application's internals.

Run locally ruby (lightweight, but only run the rails portions of the site)

  • We don't support development with sqlite3, you'll need to set up MySQL.
  • Mailcatcher is a good tool for catching emails in development.

Provision New VM

  • Provisioning relies upon SSH agent forwarding, so make sure you've set up an SSH key for in order to rsync secrets.
  • time ssh -A 'sudo wget -O /tmp/ && sudo -E bash /tmp/ staging/production'


See this wiki.


  • Production secrets are stored in an encrypted chef data bag at chef/data_bags/secrets/production.json.
    • Show secrets: knife data bag show secrets production -c /etc/chef/solo.rb --secret-file secrets/my_secret_key
    • Edit secrets: knife data bag edit secrets production -c /etc/chef/solo.rb --secret-file secrets/my_secret_key