Teambox is an open sourced project collaboration software with simple task managements, file sharing and wiki collaborations for small teams. Teambox can be used in a hosted mode (Saas version with various plans depending on how many team members and projects you need to manage) on teambox.com or the code can be downloaded from GitHub and installed on one’s own server.

 

Here is the step by step installation of the latest version of Teambox on a server running Debian Lenny (upgrade to squeeze coming soon). My thanks to Frédéric de Villamil for getting this going since he is more of a Ruby Expert than I am.

Installing the dependances :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
aptitude install build-essential

# ruby developer packages
aptitude install ruby1.8-dev ruby1.8 ri1.8 rdoc1.8 irb1.8
aptitude install libreadline-ruby1.8 libruby1.8 libopenssl-ruby

# nokogiri bundle requirements
aptitude install libxslt-dev libxml2-dev

#Git
aptitude install git-all

# Other teambox bundles requirements
aptitude install zlib1g-dev libssl-dev  libreadline5-dev libxml2-dev libxslt-ruby libxslt-dev libiconv-ruby libreadline-ruby1.8 libruby1.8  libopenssl-ruby

Downloading and installing Ruby Enterprise and Passenger:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
cd /tmp
wget http://rubyforge.org/frs/download.php/71096/ruby-enterprise-1.8.7-2010.02.tar.gz
tar -xvzf ruby-enterprise-1.8.7-2010.02.tar.gz
cd ruby-enterprise-1.8.7-2010.02/
./installer
#answer /usr for the location instead of the default /opt in order to install ruby enterprise as the system's ruby.
#press enter to complete the installation
gem update --system

# Installating passenger
gem install passenger
apt-get install libcurl4-openssl-dev  apache2-prefork-dev libapr1-dev libaprutil1-dev
passenger-install-apache2-module

# Setting up Ruby for the system
cd /usr/bin
ln -s ruby  ruby1.8

Configuring Apache :

1
vi /etc/apache2/apache2.conf

Add the following line in the file :

1
2
3
4
# Ruby passenger
LoadModule passenger_module /usr/lib/ruby/gems/1.8/gems/passenger-3.0.2/ext/apache2/mod_passenger.so
PassengerRoot /usr/lib/ruby/gems/1.8/gems/passenger-3.0.2
PassengerRuby /usr/bin/ruby

Setting up Teambox :

1
2
3
4
5
6
cd /var/www/
git clone https://github.com/teambox/teambox.git
cd teambox
bundle install
# this will take a while
# if you get errors you are missing some dependancies I already had.

Create an Apache Virtual Host for teambox inspired by the following :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
<VirtualHost *:80>
Options +Indexes
ServerAdmin myname@mydomain.com
ServerName teambox.mydomain.com
DocumentRoot /var/www/teambox/public
<Directory /var/www/teambox/public/>
Options Indexes FollowSymLinks
AllowOverride All
Order allow,deny
Allow from all
Options -MultiViews
</Directory>
RailsEnv production
</VirtualHost>

When all these steps are completed, the rest of the process is what’s covered in Teambox’ own documentation.

All you have left to do is configure your teambox and create your database :

  • copy the database configuration file
1
cp config/database.example.yml config/database.yml
  • edit your database configuration in teambox/config/database.yml
  • edit teambox main configuration file in teambox/config/teambox.yml
    Personally, I changed the domain and the email settings only
1
2
3
4
5
6
host: smtp.gmail.com
username: me@gmail.com
password: my_password
auth: plain
port: 587
enable_starttls_auto: true
  • create your database
1
bundle exec rake db:create db:schema:load RAILS_ENV=production

Finally, test your app to see if it’s working by going to teambox.mydomain.com

That was it for me. Thanks again to Fred for helping pointing me to Ruby Enterprise.

I hope this helps someone else out there…

Filed under: Computing, Debian

Tagged with: , , , , , , ,

Liked this page?

Tweet it

Subscribe to the RSS feed or sign up for the newsletter now.

Posts related to Setting up Ruby Enterprise, passenger and installing Teambox (RubyOnRails) on Debian

4 Comments to "Setting up Ruby Enterprise, passenger and installing Teambox (RubyOnRails) on Debian"

  1. Comment by Ferran on March 4, 2011 at 11:44 am Reply

    Hi Samantha,

    Great post. I find it really helpful, but just wanted to remind you that Teambox can also be used as a web app.

    Thanks!

  2. […] Setting up Ruby Enterprise, passenger and installing Teambox (RubyOnRails) on Debian […]

  3. Comment by Collaboaration Software Agent 001 on March 15, 2011 at 3:53 am Reply

    Samathana,

    You rock for posting this! We at Teambox has a happee!

    Can I send you an ‘Email destroyed my life’ T-shirt with original Ismurg art when they come out next month?

    Just email me your address.

    Ferran,

    You are awesome for pointing out our web app.

    Love makes the RoR world go round!

  4. Comment by Collaboaration Software Agent 001 on March 15, 2011 at 3:55 am Reply

    Oh, Ferran, you can find me and I will send you one too!

Name (required)

Email (required)

Website

Leave a Reply

  • About Me


    photo of Samantha Halfon Samantha Halfon
    Software Engineer
    blueKiwi software
    Paris, France
    I enjoy playing with my computer(s), listening to Bob Dylan (and related artists) and watching movies (especially if they were directed by Martin Scorsese or John Cassavetes). Sometimes, I play a little guitar... If not doing any of the above, I am either riding a small red bike around Paris, or, making videos. About my videomaking please check out World Wide Angle and its blog.