HowTo Install Redmine 231 On Ubuntu 1204 clean installation with git and Redmine Git Hosting plugin¶

Installing LAMP¶

apt-get update && apt-get upgrade -y
apt-get install tasksel
tasksel

choose LAMP server and choose a password for MySQL root account

Installing Packages¶

apt-get install ruby rubygems libruby libapache2-mod-passenger ruby-dev libmysqlclient-dev libmagickcore-dev libmagickwand-dev git git-core -y

Reboot your machine!!!

Installing Redmine¶

cd /tmp
wget rubyforge.org/frs/download.php/76933/redmine-2.3.1.tar.gz
tar -xzvf redmine-2.3.1.tar.gz
mv redmine-2.3.1 /usr/local/share/redmine-2.3.1
ln -s /usr/local/share/redmine-2.3.1 /usr/local/share/redmine
chown -R root:root /usr/local/share/redmine-2.3.1
gem install bundler
cd /usr/local/share/redmine/
bundle install --without development test postgresql sqlite

h2 .Setting up Redmine user and database in MySQL

mysql -u root -p

CREATE DATABASE redmine CHARACTER SET utf8;
CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'my_password';
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';

Configuration¶

File premissions¶

useradd redmine
mkdir -p tmp tmp/pdf public/plugin_assets
sudo chown -R redmine:redmine files log tmp public/plugin_assets
sudo chmod -R 755 files log tmp public/plugin_assets

Copy /usr/local/share/redmine/config/database.yml.example to /usr/local/share/redmine/config/database.yml and edit this file in order to configure your database settings for "production" environment.
Example for a MySQL database using ruby1.8 or jruby:

production:
  adapter: mysql2      (note: For Rails < 3.1 use mysql instead of mysql2)
  database: redmine
  host: localhost
  username: redmine
  password: my_password

Generate a session store secret:

rake generate_secret_token

Generate the database structure:

RAILS_ENV=production rake db:migrate

Generate default configuration data:

RAILS_ENV=production rake redmine:load_default_data

(using “es” for Spanish language in terminal prompt)

Database encryption¶

If you want to encrypt your redmine database do as follows:

1. Copy the default config file /usr/local/share/redmine/config/configuration.yml.example to /usr/local/share/redmine/config/configuration.yml
2. Edit configuration.yml and create a cipher key there for the environment you've used so thus far - production. Be sure to read the comment in this file. They are very detailed and there for you.
3. Run:

   rake db:encrypt RAILS_ENV=production
   

Apache¶

Setup Apache’s VirtualHost config

vim /etc/apache2/sites-available/redmine.example.com

# 8080 in this case is because we use a reverse proxy before Apache. Otherwise simply use "*:80" 

<VirtualHost *:8080>
 ServerName redmine.example.com
 DocumentRoot /usr/local/share/redmine/public
 <Directory /usr/local/share/redmine/public>
   AllowOverride all
   Options -MultiViews
 </Directory>
</VirtualHost>

TODO:: The redmine installation works but users editing return an error

Once you enable this virtual host (a2ensite redmine.example.com) and reload Apache (apache2ctl graceful), you should see your site running on http://redmine.example.com.

The default login/password is admin/admin (don't forget to change this).

Sources of inspiration¶

We used the following resources as a starting point. Thanks to their respective authors.

• http://madpropellerhead.com/random/20100820-installing-redmine-on-debian-with-apache (outdated, for Lenny)
• http://www.redmine.org/projects/redmine/wiki/RedmineInstall
• http://hodza.net/2012/03/15/howto-install-redmine-on-debian-6-squeeze-ruby-on-rails-apache2-passenger/
• http://www.redmine.org/projects/redmine/wiki/HowTo_Install_Redmine_on_Debian_with_Ruby-on-Rails_and_Apache2-Passenger