Installing on Linux

Our plugins are easy to install and do not change Redmine database data, but we recommend a full backup before installation. What is commonly done is just copy the unarchived plugin to your redmine/plugins/ folder. Some plugins, however, may require specific Ruby gems or/and database tables.

Below you will find common steps for any plugin installation (all commands should be executed from the Redmine app root folder ex. /var/www/redmine; that folder contains config.ru file)

Go to Redmine's root folder

cd /var/www/redmine

Copy and unarchive plugin

cp redmine_reporter-x_x_x-pro.zip plugins/
cd plugins
unzip redmine_reporter-x_x_x-pro.zip

Install required gems

cd /var/www/redmine
bundle install --without development test --no-deployment

Migrate plugin's tables

bundle exec rake redmine:plugins NAME=redmine_reporter RAILS_ENV=production

Setup PDF generator path

We are using wkhtmltopdf tool for generation PDFs from HTML templates. In common case you needn't to do any manipulations or additional settings. But sometimes redmine can't find wkhtmltopdf module in OS and it should be assigned in the config/configuration.yml file.

default:
  wkhtmltopdf_exe_path: [path to wkhtmltopdf tool]
  #EX: wkhtmltopdf_exe_path: '/usr/local/rvm/gems/ruby-2.4.1/bin/wkhtmltopdf'

Read full article

Restart Redmine app

For the Phusion Passenger just touch the restart.txt file

touch tmp/restart.txt

Video demonstration

Was this article helpful? Yes  No
558 from 589 found this helpful

FAQ

Getting started

Installation

Troubleshooting

Using Reporter

Related articles