Installing Invoices plugin on Bitnami Redmine virtual image (.ova)

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 /opt/bitnami/redmine

Copy the plugin archive in the root Redmine folder

In our case, we are using the File manager option for sharing files between the host machine (your computer) and the guest machine (your virtual Bitnami Redmine). It is located in the started Bitnami Redmine window top Machine menu, then File manager.

Here, you need to log-in into your guest machine (on the right). The host machine is automatically appearing as available (the file system on the left).

So, once you log-in, then navigate your host machine to the directory where your plugin is located and then copy it with the blue arrow in the middle of the screen to the /opt/bitnami/redmine directory on the right.

Then in your command line execute commands:

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 /opt/bitnami/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 Bitnami Redmine app

sudo /opt/bitnami/ctlscript.sh restart