ChiliProject is not maintained anymore. Please be advised that there will be no more updates.
We do not recommend that you setup new ChiliProject instances and we urge all existing users to migrate their data to a maintained system, e.g. Redmine. We will provide a migration script later. In the meantime, you can use the instructions by Christian Daehn.
Installation on CentOS 5¶
This is a quick guide on how to setup ChiliProject on CentOS 5.6. It is not all-encompassing but covers the basics and will get you up and running.
All commands mentioned here can be run as root, or be done through a user with sudo. This guide will walk through starting as root, creating a user, and then completing the installation as that user, however everything will work if you choose to do it entirely as root.
We are going to setup and install the following:
- Ruby Enterprise Edition (REE)
This is a standard setup, however you can replace Apache and passenger easily with your application server of choice, as well as choose a different version of Ruby or database without much hassle.
Global dependencies and basic system setup¶
Enable the EPEL repository, so we can grab slightly more up-to-date versions of some packages, as well as subversion and git:
su -c 'rpm -Uvh http://dl.fedoraproject.org/pub/epel/5/i386/epel-release-5-4.noarch.rpm'
Install apache, mysql, git, subversion, the required build libraries, as well as a few extra's.
Please pay attention to what you are getting here, and if something does not fit your requirements, it's very likely you can do without it, or choose an alternative. Here we simply tried to cover all our bases so the installation is smooth.
yum install gcc zlib zlib-devel curl curl-devel expat-devel gettext-devel httpd httpd-devel apr-devel apr-util-devel mysql mysql-server mysql-devel openssl openssl-devel make gcc-c++ patch readline-devel ImageMagick ImageMagick-devel libffi-devel libyaml-devel sudo git subversion
Start httpd and mysql and enable them to run on boot:
/etc/init.d/httpd start /sbin/chkconfig httpd on /etc/init.d/mysqld start /sbin/chkconfig mysqld on
Create a user that we are going to put chiliproject under, in this tutorial this user will be called chili.
adduser chili passwd chili
Install Ruby, Gems, and ChiliProject-Specific Dependencies¶
Depending on your long-term plans we suggest adding the user chili to /etc/sudoers (using visudo) so you can later disable root logins for a more secure environment. This tutorial will assume you have done so, and at this point are logged in as the chili user. If you choose not to do this, this tutorial will still work just fine executing these as root.
In this example we are going to install just a single version of ruby to use just for our chili user. The following should be done as the chili user, unless otherwise mentioned.
bash < <(curl -s https://rvm.beginrescueend.com/install/rvm)
Add this line to the bottom of .bash_profile
[[ -s "$HOME/.rvm/scripts/rvm" ]] && . "$HOME/.rvm/scripts/rvm"
Log out and log back in so your shell picks up these changes.
Ensure rvm is installed and running as a function
type rvm | head -1
Update and reload rvm (just in case)
rvm get head rvm reload
Install Ruby Enterprise Edition and set it as the default, this may take some time depending on your hardware.
rvm install ree rvm --default use ree
Install rails and required gems¶
Install rails version 2.3.5, the mysql gem, and the correct version of the i18n gem
gem install rails --version 2.3.5 gem install mysql gem install -v=0.4.2 i18n
These are some optional gems you may want to install. rmagick will give you pretty graphs and ruby-openid will enable the ability to activate openid logins.
gem install rmagick -v 1.15.13 -- --build-flags --disable-htmldoc gem install ruby-openid
Follow the prompts and read the last part of the output instructing you to copy-paste some lines into your /etc/httpd/conf/httpd.conf
gem install passenger rvmsudo passenger-install-apache2-module
While we are editing httpd.conf, let's go ahead and create a virtualhost entry, edit as neccessary:
<VirtualHost *:80> ServerName www.demo.chiliproject.org ServerAlias demo.chiliproject.org DocumentRoot /home/chili/chiliproject/public <Directory /home/chili/chiliproject/public> AllowOverride all Options -MultiViews </Directory> </VirtualHost>
Follow the standard Installation guide. In this guide, we are going to
- get the ChiliProject code,
- put it in the correct place,
- connect it to the chosen database, and
- perform a basic configuration
Help, and changing what get's installed¶
As mentioned earlier, you can easily switch many of the items installed here with alternatives, however this guide will not cover all of them. Check the ChiliProject Blog, or SikhNerd's Blog for additional information. You can also ask relevant questions on the forums or in IRC and we will be happy to help you out.