Redmine installation on Ubuntu 16.04

This manual will help you to install fresh Redmine version from sources to Ubuntu server.

1. Installing RVM (Ruby Version Manager)

$ sudo su
# apt-get install mysql-server libmysqlclient-dev git-core subversion imagemagick libmagickwand-dev libcurl4-openssl-dev 
# gpg --keyserver hkp:// --recv-keys D39DC0E3
# curl -L | bash -s stable --ruby=2.2.6
Now, you should load the RVM
# source /usr/local/rvm/scripts/rvm
# echo '[[ -s "/usr/local/rvm/scripts/rvm" ]] && source "/usr/local/rvm/scripts/rvm"' >> ~/.bashrc

2. Installing Phusion Passenger and Nginx

# gem install passenger --no-ri --no-rdoc
# passenger-install-nginx-module

Configuring nginx

# systemctl stop nginx
# curl > /lib/systemd/system/nginx.service
# systemctl daemon-reload
# systemctl enable nginx
# nano /opt/nginx/conf/nginx.conf

Replace server section for port 80

server {
  listen  80;
  server_name [your_server_domain_name] #;
  root /var/data/redmine/public;
  passenger_enabled on;
  client_max_body_size      10m; # Max attachemnt size

Restart nginx

# systemctl stop nginx
# systemctl start nginx

3. Installing Redmine

# mkdir /var/data
# cd /var/data/
# svn co redmine
# cd /var/data/redmine

Database configuration

# nano config/database.yml

Add following lines

  adapter: mysql2
  database: redmine
  host: localhost
  username: redmine
  password: redmine
  encoding: utf8

  adapter: mysql2
  database: redmine 
  host: localhost
  username: redmine
  password: redmine
  encoding: utf8

4. Plugins installation

Unarchive plugins to /plugins/ folder
# cd /var/data/redmine
# gem install bundler --no-ri --no-rdoc
# bundle install

5. Configuring redmine

Setup redmine folder permissions

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

Create database

# mysql -u root -p

Execute following lines to MySQL

CREATE DATABASE redmine character SET utf8;
CREATE user 'redmine'@'localhost' IDENTIFIED BY 'redmine';
GRANT ALL privileges ON redmine.* TO 'redmine'@'localhost';

Migrate database

# cd /var/data/redmine
# bundle exec rake db:migrate
# bundle exec rake redmine:plugins

If you want to, you can download some default data (statuses, workflows, trackers) to be able to start to work with your Redmine right after the first login. To do this, run the following command:

# bundle exec rake redmine:load_default_data RAILS_ENV=production

It will ask you about preferable language and then download some default package of data to your Redmine.

Generate session store

# bundle exec rake generate_secret_token 

Start web server

# service nginx start

Restart Redmine

# touch /var/data/redmine/tmp/restart.txt
Was this article helpful? Yes  No
58 from 116 found this helpful