Install plugins

NOTE: We are in the process of modifying the file structure and configuration for many Bitnami stacks. On account of these changes, the file paths stated in this guide may change depending on whether your Bitnami stack uses native Linux system packages (Approach A), or if it is a self-contained installation (Approach B). To identify your Bitnami installation type and what approach to follow, run the command below:

 $ test ! -f "/opt/bitnami/common/bin/openssl" && echo "Approach A: Using system packages." || echo "Approach B: Self-contained installation."

The output of the command indicates which approach (A or B) is used by the installation, and will allow you to identify the paths, configuration and commands to use in this guide. Refer to the FAQ for more information on these changes.

NOTE: Before installing a plugin, make sure that the plugin is compatible with your OpenProject version.

  • Navigate to the OpenProject installation directory. Execute the following commands, depending on your installation type:

    • Approach A (Bitnami installations using system packages):

        $ cd /opt/bitnami/openproject
    • Approach B (Self-contained Bitnami installations):

        $ cd /opt/bitnami/apps/openproject
  • OpenProject plug-ins are separated in Ruby gems. You can install them by including the gems in a custom Gemfile.plugins file, for example:

      gem "openproject-pdf_export", git: "", :branch => "stable"
  • Then, to install the plugin, run the following commands:

      $ bundle install --no-deployment --without development test development
      $ RAILS_ENV="production" bundle exec rake db:migrate
      $ RAILS_ENV="production" bundle exec rake db:seed
      $ RAILS_ENV="production" bundle exec rake assets:precompile
      $ touch tmp/restart.txt

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


If you run the previous commands as the root user, change permissions of the tmp folder, located under the OpenProject installation directory:

$ chown -R daemon:daemon tmp
Last modification September 27, 2022