HowTo Install Redmine 231 On Ubuntu 1204 clean installation with git and Redmine Git Hosting plugin¶
- Table of contents
- 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
It is not necessary to reboot your machine.
Installing Redmine¶
cd /tmp wget http://www.redmine.org/releases/redmine-2.3.4.tar.gz tar -xzvf redmine-2.3.4.tar.gz mv redmine-2.3.4 /usr/local/share/redmine-2.3.4 ln -s /usr/local/share/redmine-2.3.1 /usr/local/share/redmine chown -R root:root /usr/local/share/redmine-2.3.4 gem install bundler People may find the following helpful: gem install rdp-mysql2 cd /usr/local/share/redmine/ bundle install --without development test postgresql sqlite
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 permissions¶
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
(Note - do this upon error message about mysql2: bundle install )
Generate the database structure:
bundle exec rake db:migrate RAILS_ENV=production
Generate default configuration data:
bundle exec rake redmine:load_default_data RAILS_ENV=production
Encrypt SCM and LDAP passwords¶
If you want to encrypt SCM and LDAP passwords do as follows:
- Copy the default config file
/usr/local/share/redmine/config/configuration.yml.example
to/usr/local/share/redmine/config/configuration.yml
- 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.
- Run:
bundle exec rake db:encrypt RAILS_ENV=production
Apache¶
Setup Apache’s VirtualHost config
vim /etc/apache2/sites-available/redmine.example.com
# 8080 just in this case; it is because we use a reverse proxy before Apache. Otherwise simply use the standard "*: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>
(Note: That didnt work out for me, so I played it fast and loose by killing the 'default' file and using the 'modified
default' from http://imsunnyshah.wordpress.com/2013/04/29/how-to-setup-redmine-2-3-0-on-ubuntu-12-10/ )
TODO:: The redmine installation works, but user editing return an error when using Passenger and adding Git Plugin
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
Updated by Jan Niggemann (redmine.org team member) almost 11 years ago · 19 revisions