Redmine

h1. HowTo install Redmine on Debian with Passenger

{{>toc}}

*This is work in progress. Please see the guide on [[HowTo_Install_Redmine_on_Debian_with_Ruby-on-Rails_and_Apache2-Passenger]] for now.*

This guide is going to explain how to install Redmine 0.9.x, 1.0.x, or trunk for a production setup on a Debian 5.0.x "Lenny".

Although, there exists a "Redmine package":http://packages.debian.org/lenny-backports/redmine in lenny-backports and above, I would recommend to not use it for now, as it patches Redmine to run on various older libraries (foremost Rails). If you run Squeeze, it should be easier to use the provided package. However, you are more flexible and probably get better support in the forums or in IRC when you use the redmine.org provided package. This is obviously the preferred method of deployment here.

h2. What we are going to do here?

At first, we need to make sure to meet the general requirements on [[RedmineInstall]]. At the time of writing, this included:

* Ruby 1.8.7 (preferred), 1.8.6 is also okay. Redmine is still not fully compatible with Ruby 1.9.x and JRuby

* Rubygems 1.3.1 or higher

* Rails 2.3.5 with dependencies

* Rack 1.0.1. Version 1.1 is not supported with Rails 2.3.5

Finally, we are going to install Apache 2.2 or Nginx together with passenger and set them up with redmine.

We are now walking through to install all these packages.

h2. Install Ruby

At first, we install the base ruby. Luckily, Debian Lenny ships with ruby 1.8.7 by default:

<pre>

aptitude install ruby1.8 irb1.8 rdoc1.8 ri1.8 libreadline-ruby1.8 libopenssl-ruby1.8

</pre>

h2. Setup lenny-packports to install passenger and some requirements from debian packages

This step is not necessary if you run a newer Debian distribution than Lenny. So if you run Squeeze or Sid, just skip this.

At first, we are adding the official @lenny-backports@ repository to our @sources.list@. This repository provides newer or additional packages compiled to run with Debian Lenny. Most of the time, it will include the software versions from the current testing distribution.

<pre>

echo "deb http://www.backports.org/debian lenny-backports main" >> /etc/apt/sources.list

aptitude reload

</pre>

Next we are going to instruct APT to prefer the current Debian stable release over the backports packages. Additionally, we are pinning some packages from backports such that these are installed and preferred over the stable release versions.

<pre>

cat <<EOF > /etc/apt/preferences

Package: *

Pin: release o=Debian,a=stable

Pin-Priority: 101

Package: *

Pin: release a=lenny-backports

Pin-Priority: 1

Package: rubygems

Pin: release a=lenny-backports

Pin-Priority: 999

Package: rubygems1.8

Pin: release a=lenny-backports

Pin-Priority: 999

Package: rake

Pin: release a=lenny-backports

Pin-Priority: 999

Package: librack-ruby1.8

Pin: release a=lenny-backports

Pin-Priority: 999

EOF

</pre>