generalredmine

Install plugins

Before installing a plugin, make sure that the plugin is compatible with your Redmine version. For plugins from the Redmine Plugin Directory. Select your Redmine version and check if the plugin is compatible or not with your version using the drop down menu located in the top right margin: “Show only plugins compatible with Redmine: version”.

  • Get the .zip file or clone the git repository in the /opt/bitnami/apps/redmine/htdocs/plugins directory:

    $ cd /opt/bitnami/apps/redmine/htdocs/plugins
    
  • If you have obtained a .zip file, Once you have the plugin .zip file, uncompress it an remove the .zip file. (Remember to replace PLUGIN_NAME-x-y-z with the correct name and version of the plugin):

    $ unzip PLUGIN_NAME-x-y-z.zip
    $ rm PLUGIN_NAME-x-y-z.zip
    

IMPORTANT: Before installing the plugin, check the installation notes indicated in the plugin description or readme. Some plugins need special installation requirements.

  • Install the plugin in the htdocs directory:

    $ cd /opt/bitnami/apps/redmine/htdocs/
    $ bundle install
    $ bundle exec rake redmine:plugins NAME=PLUGIN_NAME RAILS_ENV=production
    

    NOTE: It could display a warning message about the log production file. In that case, run the following commands:

    $ sudo chown :bitnami log/production.log
    $ sudo chmod g+w log/production.log
    
  • Restart Apache services:

    $ sudo /opt/bitnami/ctlscript.sh restart
    

Troubleshooting plugin installation

  • If you receive an error like this in Redmine 2.4.0-0 and newer:

    You are trying to install in deployment mode after changing your Gemfile. Run ‘bundle install’ elsewhere and add the updated Gemfile.lock to version control.

    Try adding the --no-deployment argument to the bundle install command as suggested in the error message.