Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Project Useful

Project Useful is a Ruby on Rails-based project management system implementing the Scrum Agile methodology.

System Requirements

  • Ruby version 2 or later

  • Rails 5.2.1

  • Bootstrap 4

  • MySQL or MariaDB 5.1 or later


The system is being developed on a system using MySQL 5.1.46. Later versions as well MariaDB should also work.

Create a database for production. If you plan to do development or testing of the system you'll also need a corresponding database.

Create a user for Project Useful and grant all rights to the databases to the user. Make sure to update your config/database.yml file with the appropriate database, username, and password.


Make sure you update your secret token before running the application! config/initializers/secret_token.rb

Author, Copyright, and License

Project Useful is copyright 2020 by Shannon M. Hauck, .

Project Useful is released under the GNU Affero General Public License. See the LICENSE file for details.

Sections still to write

  • Configuration

  • Database initialization

The datatbase currently needs to be setup manually. Login with admin privileges (root) and create a new database for Project Useful. Then grant permissions to a new database user that you want to own the database. Replace USER and PASSWORD with appropriate information.

create database project_useful;
grant all on projectuseful.* to 'USER'@'DATABASE_SERVER' identified by 'PASSWORD';
  • How to run the test suite

  • Services (job queues, cache servers, search engines, etc.)

  • Deployment instructions is currently running through Apache / Phusion Passenger. Setup a virtual host for the application similar to the following:

<VirtualHost *:80>
    ServerName ""
    ServerAlias ""
    DocumentRoot /path/to/project_useful/public
    ErrorLog "logs/"
    CustomLog "logs/" common
    RailsBaseURI /rails
    <Directory "/path/to/project_useful/public">
      Options FollowSymLinks Includes
      AllowOverride None
      Order deny,allow
      Allow from all