In this tutorial we will install Redmine on a clean installation of Ubuntu server 14.04 with an Apache server and MySql.
Redmine wil be reachable under the subdomain
Here Redmine will be installed to
unzip to unpack the archive.
The placeholder for the username you’re logged into the system is
Step 1 – Installing required software
First we need to update our packages.If you encounter any problems later on try to fix them by updating your packages again.
sudo apt-get update && sudo apt-get -y upgrade
Now install apache2 and mysql:
sudo apt-get install apache2 mysql-server mysql-client
While installing mysql-server you will be asked for a MySql root password to set.
Step 2 – Database creation
To create the database log in as root user with the password you set earlier.
mysql -u root -p
The following MySql queries create the database and the user to access this database. Be sure you have my_password replaced with an other password (not the root password) before executing.
CREATE DATABASE redmine CHARACTER SET utf8; GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost' IDENTIFIED BY 'my_password';
mysql simply type
exit and execute.
Step 3 – Downloading Redmine
Now switch in your vhosts directory download Redmine and unzip it. If you want you can use the .tar.gz file with the tar command as well.
cd /var/www/vhosts wget http://www.redmine.org/releases/redmine-3.0.1.zip unzip redmine-3.0.1.zip mv redmine-3.0.1 redmine
Step 4 – Database configuration
We need to alter the file
/var/www/vhosts/redmine/config/database.yml.example and save it as
my_password with the password set in the MySql query before.
production: adapter: mysql2 database: redmine host: localhost username: redmine password: my_password
If your MySql server is running on another Port (eg. 3344) you can use the following config:
production: adapter: mysql database: redmine host: localhost port: 3344 username: redmine password: my_password
Step 5 – Installing ruby
First we have to remove the old version of ruby.
sudo apt-get remove ruby
Execute the following command (not as root user) with the ‚\‘ at the beginning.
It will install ruby at your system, usable for every user in the group rvm.
The installation folder is
\curl -sSL https://get.rvm.io | sudo bash -s stable --rails
In my case the first run failed because of a missing signature. The command to install this signature will be displayed in the error-message. In my case it was this:
sudo gpg --keyserver hkp://keys.gnupg.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3
Then rerun the command to install ruby.
After some time ruby is installed with rails.
Now the users
www-data need to be added to the group
sudo usermod -aG rvm $sysUser$ sudo usermod -aG rvm www-data
After a relogin the change should be applyed. You have to switch folders back to your Redmine folder.
gem install bundler bundle install --without development test rmagick
If you encounter any problems with mysql during installation execute
sudo apt-get install libmysqlclient-dev.
Then execute the command again.
Step 6 – Configuring Redmine with ruby
Generate a secret cookie token:
bundle exec rake generate_secret_token
Create the database structure:
RAILS_ENV=production bundle exec rake db:migrate
Insert the default configuration:
RAILS_ENV=production bundle exec rake redmine:load_default_data
Start the webrick server to test if everything is ok. You can access the webrick server from localhost only, so its ok if it throws no errors while starting. Then shutdown the webrick server.
bundle exec ruby bin/rails server webrick -e production
Step 7 – Installing passenger
Because the repository version of passenger will install the old ruby from the repository again, we have to install it via gem.
gem install passenger
Now we have to install some other packages, required for passenger integration in apache2:
sudo apt-get install libcurl4-openssl-dev apache2-threaded-dev libapr1-dev libaprutil1-dev
Then execute the following commands to install the passenger module to apache2.
sudo -i passenger-install-apache2-module
Alter the file
/etc/apache2/mods-avaiable/passenger.load to this:
And the file
/etc/apache2/mods-available/passenger.conf to this:
Now enable the passenger mod:
Step 8 – Configuring Apache
To reach redmine under
redmine.example.com we have to create a new file in
I called the file
To activate the site execute
a2ensite redmine.example.com.conf and rename the file
Now restart apache2 via
sudo service apache2 restart.
Everything should be up and running.
- http://www.interworx.com/support/faq/how-to-install-ruby-on-rails-and-passenger/ [Link is down for some reason]