Redmine

Installation

Requisites:

Subversion installed
Ruby installed - aligned with Ruby version required for different Redmine versions
MySQL database - using MariaDB here (10.X)

Here we use the subversion directory since the upgrade path is much easier.

# Pull stable v5.0.X branch
mkdir -p /var/www/redmine/
cd /var/www/redmine
svn co https://svn.redmine.org/redmine/branches/5.0-stable redmine-5.0

Add this to the configuration in Redmine (if using dockerized MariaDB, host must be 127.0.0.1 and not localhost):

$REDMINE_ROOT/config/database.yml

production:
  adapter: mysql2
  database: redmine
  host: 127.0.0.1  # cannot use localhost!
  port: YOUR_PORT_NUMBER
  username: YOUR_REDMINE_USER
  password: "YOUR_REDMINE_USER_PASSWORD"
  # Use "utf8" instead of "utfmb4" for MySQL prior to 5.7.7
  encoding: utf8mb4

For Ubuntu, need to install MySQLClient packages:

sudo apt install default-libmysqlclient-dev

Install the Gemfiles (the --without flag is specified for when development and test database adapters are also defined in the database.yml file):

bundle install --without development test

Generate secret token:

bundle exec rake generate_secret_token

Database schema creation:

RAILS_ENV=production bundle exec rake db:migrate

Database default dataset installation:

RAILS_ENV=production REDMINE_LANG=en bundle exec rake redmine:load_default_data

For testing with Webrick, note the change in syntax for Rails 6. Make sure the firewall port is open!

> bundle add webrick
> bundle install
> bundle exec rails server -u webrick -e production -p 3011

Login to Redmine with admin:admin at http://YOUR_IP:3011 and change password + configure away.

Themes: