Preface¶
Last updated: Nov. 1st, 2016 (Redmine 3.3 on Deb. 8 (64 Bits))
Download a PDF of the original document from my site: http://files.hz6.de/redmine/InstallingRedmine_EN.pdf
Deutsche Version unter http://files.hz6.de/redmine/InstallingRedmine_DE.pdf
After reading this guide you should have a working redmine instance.
If this is not the case or if a step fails, 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.
If this guide has issues, please contact me or correct it yourself.
About this guide¶
This is a step-by-step guide to install redmine on "Debian stable" (called Wheezy at the moment of writing).
It is written for people who are familiar with Debian, the shell, MySQL, Apache and Linux in general.
To keep this guide short, it does not explain every step in detail.
The versions, filenames and paths in this document are subject to frequent change. I'll do my best to keep them up-to-date, but please check anyway.
Please note: I'm assuming that you know how to use the tools at hand. If that's not the case (eg. you don't know how to create a new database or you don't know how to restart apache) please use the search engine of your choice and come back afterwards.
Chapter 1: Install ruby, rails, gems and passenger¶
Read chapter 1Read chapter 1
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 -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 2.3.1pXXX (2016-06-27 revision 41675) [x86_64-linux]
ruby –v
1.4 make ruby support OpenSSL¶
cd ext/openssl/
ruby extconf.rb
make
su
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 -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
Chapter 2: Install redmine¶
Read chapter 2Read chapter 2
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.
Chapter 3: Configure apache and passenger¶
In this guide, we deploy to a sub-URI. Read other guides if you want a name-based virtual host configuration.
Read chapter 3Read chapter 3
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.