1.1 Prepare your system¶

apt-get install gcc build-essential zlib1g zlib1g-dev zlibc libssl-dev libyaml-dev libcurl4-openssl-dev apache2-mpm-prefork apache2-dev libapr1-dev libxslt1-dev checkinstall
apt-get build-dep ruby

1.2 download, build and install ruby¶

double check for compliance with here:

http://www.redmine.org/projects/redmine/wiki/RedmineInstall

cd ~
# wget ftp://ftp.ruby-lang.org/pub/ruby/1.9/ruby-1.9.3-p547.tar.gz
# tar xvfz ruby-1.9.3-p547.tar.gz
# cd ruby-1.9.3-p547
wget -c ftp://ftp.ruby-lang.org/pub/ruby/2.3/ruby-2.3.1.tar.gz
tar xvfz ruby-2.3.1.tar.gz
cd ruby-2.3.1
./configure --enable-pthread --prefix=/usr/local

• read and check the output carefully :)
• add if needed missed packages

make 
su
checkinstall --type=debian --install=yes --fstrans=no --pakdir='~'

1.3 check if ruby works¶

Expected output: ruby 1.9.3p547 (2013-06-27 revision 41675) [i686-linux]

ruby –v

1.4 make ruby support OpenSSL¶

cd ext/openssl/
ruby extconf.rb
make && checkinstall --type=debian --install=yes --fstrans=no --pakdir='~'

1.5 gem installed?¶

Ruby 1.9 comes with RubyGems by default, so by now gem should be installed. If correctly installed, the following command will output a version number like 1.8.2x:

gem -v

We can now install rdoc:

gem install rdoc

1.6 install rails¶

check with here:

https://rubygems.org/gems/rails/versions
http://www.redmine.org/projects/redmine/wiki/RedmineInstall

and force the version number (otherwise the latest version will be installed)

#gem install rails --no-ri --no-rdoc
gem install rails -v=4.2.7.1 --no-ri --no-rdoc

Note: You may be getting the error message "no such file to load --zlib (LoadError)". In this case
you need to install zlib first:

cd ruby-1.9.3-p547/ext/zlib/
ruby extconf.rb
make
make install

1.7 install passenger (application server)¶

gem install passenger
passenger-install-apache2-module

1.8 configure apache¶

Put this in /etc/apache/mods-available/passenger.load (remember to adjust the paths if necessary).

LoadModule passenger_module /usr/local/lib/ruby/gems/1.9.1/gems/passenger-4.0.46/ext/apache2/mod_passenger.so

And put this in /etc/apache/mods-available/passenger.conf (remember to adjust the paths if necessary).

PassengerRoot /usr/local/lib/ruby/gems/1.9.1/gems/passenger-4.0.46
PassengerRuby /usr/local/bin/ruby
PassengerDefaultUser www-data

1.9 activate module¶

a2enmod passenger

2.1 download redmine¶

Get latest zip from here and unpack to /opt/redmine

2.2 further prepare the system¶

Note: Installing libmagickwand-dev installs a lot of packages (depends / recommends)
Note: If you have bundle install error then you may try to purge, then install *-dev packages

gem install bundler mysql2
apt-get install libmagickwand-dev libmysqlclient-dev
cd /opt/redmine
bundle install --without postgresql

2.3 create database¶

create database redmine character set utf8;
create user 'redmine'@'localhost' identified by 'XXX';
grant all privileges on redmine.* to 'redmine'@'localhost';

2.4 configure DB-connection¶

Put this in /opt/redmine/config/database.yml

production:
  adapter: mysql2
  database: redmine
  host: localhost
  username: redmine
  password: XXX

2.5 generate a session store secret¶

rake generate_secret_token

2.6 prepare database / create tables¶

RAILS_ENV=production rake db:migrate

2.7 set filesystem permissions¶

cd /opt/redmine
mkdir tmp tmp/pdf public/plugin_assets
chown -R www-data:www-data files log tmp public/plugin_assets
chmod -R 755 files log tmp public/plugin_assets

2.8 test if it works¶

Redmine 2.x.x

ruby script/rails server webrick -e production

Redmine 3.x.x

bundle exec rails server webrick -e production

Now go to http://localhost:3000 and see redmine in action.

3.1 Configure apache (subURI deployment)¶

ln -s /opt/redmine/public /var/www/redmine

Put this in /etc/apache2/sites-available/redmine
Note: The option RackBaseURI is for rails 3, in rails 2 it was called RailsBaseURI. It is in no case called RakeBaseURI.

<Location /redmine>
        RailsEnv production
        RackBaseURI /redmine
        Options -MultiViews
</Location>

Restart apache, test if http://yourhost.com/redmine is working, rejoice if it is :-)

If you see something unexpected, please post details on the forums and refer to this wiki page. Make sure to include the output of gem env and / or RAILS_ENV=production /opt/redmine/script/about.