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)

Install CRM plugin

Note: Proper work of this plugin required installed CRM Plugin additionally. If you do not have the CRM plugin installed, please get it here. You can use a Free - Light version, which would be enough for a proper functioning of this plugin. To install CRM plugin please follow this guide: CRM plugin installation on Linux

Go to Redmine's root folder

cd /var/www/redmine

Copy and unarchive plugin

cp redmine_contacts_invoices-x_x_x-pro.zip plugins/
cd plugins
unzip redmine_contacts_invoices-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_contacts_invoices 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
402 from 451 found this helpful