Setting up Taskboard

How to install and run Taskboard

Currently we only support install instructions for Linux machines (tested on Ubuntu) as some required Ruby native extensions (juggernaut) do not work well on Windows.

The guide is prepared for Ubuntu (Debian). If you have a different distribution of Linux you have to change the command “sudo apt-get install” with the specific for your OS.

System dependencies

You can skip these steps if you have all the required software installed already.
As Taskboard is a Ruby on Rails application you need to have Ruby and Rails installed on your machine.

1. Install Ruby (recomended version is 1.8.7)

   1. sudo apt-get install ruby ruby-dev libopenssl-ruby rdoc

2. Download Ruby Gems from here and install it (recomended version is 1.3.2)
   • Because of problems with tgz files in Ubuntu 9.04 we recommend using zip archive.
   • Change ‘x’ below to your version number

   • unzip rubygems-1.3.×.zip
     
     cd rubygems-1.3.x
     
     sudo ruby setup.rb
     
     sudo ln -s /usr/bin/gem1.8 /usr/bin/gem

3. Install Rails gem

   1. sudo gem install -v=2.3.2 rails

Taskboard also needs some database to keep it’s data in, so you will need to set-up one also. By default we use MySQL but any database that works with Rails will be OK.

1. To install MySQL will all needed stuff:

   1. sudo apt-get install mysql-server mysql-client libmysqlclient-dev

2. To install MySQL support for Ruby:

   1. sudo gem install mysql

To download the source directly from repository you will need Git installed

1. sudo apt-get install git

Setting up the Taskboard application

1. Download the source
2. Clone repository

   1. git clone git://github.com/CognifideLabs/taskboard.git

3. Install all plugins

   1. cd taskboard
      
      sudo rake gems:install

4. Create configuration files

   1. cp config/database.example.yml config/database.yml
      
      cp config/juggernaut.example.yml config/juggernaut.yml
      
      cp config/juggernaut_hosts.example.yml config/juggernaut_hosts.yml
      
      config/juggernaut_hosts.yml

5. Prepare database
   1. Create database with name setup in the database.yml in section “production”

   2. rake db:migrate

Running the Taskboard app

1. Run juggernaut server

   1. juggernaut -c config/juggernaut.yml

2. Run Taskboard server

   1. scripts/server

3. Launch your browser and open address: localhost:3000
4. Have fun!