Installation

NITROCompetitions is a Ruby on Rails (RoR) application, so installation isn't much different than other RoR applications. However, there are a few additional steps that are required, which we'll go over here.

Setup database

Rather than store database credentials in source control, NITROCompetitions uses a symbolic link in place of the standard Rails file, config/database.yml.

To connect your deployment to your database, create a symbolic link called config/database.yml and point it to your config file. At NUBIC we point the symlink to /etc/nubic/db/nitro_competitions.yml, but it really doesn't matter where the file goes.

Take a look at config/database.yml.example if you want an example of what your database config file should contain.

Minimal database entries

Assuming your database is connected and working you can run the following task to fill your database with minimal data for testing and development purposes.

bundle exec rake setup:reset_demo

Assumptions about this task:

• You're NOT running it in production, as it will wipe your data.
• You're not using OmniAuth. This task sets up local application user accounts you can use to login.

After resetting:

You can login to the application with any of three user accounts, all of which have the password of demo

• admin
• reviewer
• user

Checkout our public demo server for an idea of how things should work when you're done.

Customizing for your institution

See the file config/initializers/nucats_assist.rb for all the settings/branding options available for your installation.