Before installing a plugin, make sure that the plugin is compatible with your Redmine version. For plugins from the Redmine Plugin Directory, check the “Compatible with:” field for each plugin.
- Load the Bitnami stack environment by executing the installdir/use_redmine script (Linux and Mac OS X) or by clicking the shortcut in the Start Menu under “Start -> Bitnami Redmine Stack -> Application console” (Windows). Learn more.
- Download the plugin and copy it into installdir/apps/redmine/htdocs/plugins.
If the plugin requires a migration, run the following commands to upgrade your database. It is advisable to back up the database before running these commands.
$ cd installdir/apps/redmine/htdocs/ $ bundle install --without development test postgresql sqlite $ ruby bin/rake redmine:plugins RAILS_ENV=production
After copying the plugin into the installdir/apps/redmine/htdocs/plugins directory, run these commands:
$ cd installdir/apps/redmine/htdocs/ $ bundle install --without development test postgresql sqlite --no-deployment $ bundle install --without development test postgresql sqlite --deployment $ ruby bin/rake redmine:plugins RAILS_ENV=production
Restart Redmine using these instructions.
Troubleshooting plugin installation
If you receive an error like this in Redmine 2.4.0-0 and better:
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.
If you are using the Bitnami Redmine installer for Windows and your Thin servers don’t run after installing a plugin, run them manually to understand the error:
- Go to the Bitnami Redmine console: “Start -> Program Files -> Bitnami Redmine Stack -> Use Redmine”
- Go to apps/redmine/htdocs.
Run the following command:
$ bundle exec thin start -e production -p 3001 --prefix /redmine
Now, you will be able to see the error when starting the servers or accessing the application through a Web browser at http://127.0.0.1:3001/redmine.