Install plugins - manual installation

OpenProject plugins come under the form of Ruby gems. The packaged and docker based installation come with default plugins installed (the ones found in the Community Edition of OpenProject).

For a manual installation, you can choose to install a different set of plugins by following the instructions below.

How to install a plugin

You can install plugins by listing them in a file called Gemfile.plugins. An example Gemfile.plugins file looks like this:

# Required by backlogs
gem "openproject-pdf_export", git: "", :branch => "stable/5"

gem "openproject-backlogs", git: "", :branch => "stable/5"

If you have modified the Gemfile.plugins file, always repeat the following steps of the OpenProject installation:

[openproject@debian]# cd ~/openproject-ce
[openproject@debian]# bundle install
[openproject@debian]# npm install
[openproject@debian]# RAILS_ENV="production" bundle exec rake db:migrate db:seed assets:precompile

Restart the OpenProject server afterwards (no need to restart Apache(:

[openproject@debian]# touch ~/openproject-ce/tmp/restart.txt

The next request to the server will take longer (as the application is restarted). All subsequent request should be as fast as always.

Always make sure that the plugin version is compatible with your OpenProject version (e.g. use the ‘stable’ branch of both software -- OpenProject, and the plugin).


You can find the master document in GitHub. You can propose a change to this guide by creating a pull request on GitHub.
Edit this page on GitHub