nativeInstallerredmine

Install plugins

Before running the commands shown on this page, you should load the Bitnami stack environment by executing the installdir/use_APPNAME script (Linux and Mac OS X) or by clicking the shortcut in the Start Menu under “Start -> Bitnami APPNAME Stack -> Application console” (Windows). Learn more.

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
    
  • Restart Redmine using these instructions for Linux, Windows and MacOS.

  • 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.