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)

   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

   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:

   sudo apt-get install mysql-server mysql-client libmysqlclient15-dev

2. To install MySQL support for Ruby:

   sudo gem install mysql

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

sudo apt-get install git

Setting up the Taskboard application

1. Download the source
2. Clone repository

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

3. Install all plugins

   cd taskboard
   
   sudo rake gems:install

4. Create configuration files

   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”

      rake db:migrate

Running the Taskboard app

1. Run juggernaut server

   juggernaut -c config/juggernaut.yml

2. Run Taskboard server

   scripts/server

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