Skip to content
David A. Wheeler edited this page Aug 11, 2016 · 1 revision

Installation

It is possible to install the "BadgeApp" web application, for either a development environment or for deployment. On most systems this is a fairly quick and painless process. However, we don't test the installation script as often (because existing developers have already installed it), so you might find problems; please let us know and help us fix it for your environment!

We provide a simple script that does the work, and we emphasize using widely-used tools designed for the purpose. Our installation approach installs a specific version of Ruby and specific versions of the Ruby gems that BadgeApp uses (including the ones in Rails). The web application is implemented with Ruby on Rails. In development we store data in SQLite; the production system stores the data in Postgres. More specific instructions are available here.

Installation Tips

  1. Be patient, if a specific part of the installation script does not work, it may be useful to run commands that fail directly from the command line.

  2. The script variables are not handled in a terribly robust way, such that CTRL-C/re-run script may not be successful. A simple fix may be deleting the .rbenv folder and re-running the script.

  3. Using Mac OS X it may be necessary to install the postgresql server from macports rather than brew because of the way macports sets up the server.

  4. It is possibly best to do everything within a virtual machine. This will allow you to blow away mistakes and reset much quicker during the installation process.