Install the Agile plugin

Before running the commands shown on this page, you should load the Bitnami stack environment by executing the installdir/use_APPNAME script (Linux and MacOS) or by clicking the shortcut in the Start Menu under “Start -> Bitnami APPNAME Stack -> Application console” (Windows). On OS X VMs, the installation directory is /opt/bitnami and OS X VM users can click the “Open Terminal” button to run commands. Learn more about the Bitnami stack environment and about OS X VMs.

To manually install the Redmine Agile plugin (free registration is required). It is strongly recommended to create a backup first. Once your backup is done, follow these steps:

  • Save the .zip file in the installdir/apps/redmine/htdocs/plugins directory. Make sure that you are in that directory before unzip the plugin:

      $ cd installdir/apps/redmine/htdocs/plugins
  • Unzip the Agile plugin file (VERSION-EDITION is a placeholder. Your file should contains the version you have downloaded and the selected edition):

      $ unzip
  • Remove the “.zip” file:

      $ rm
  • Change to the htdocs directory and install required gems:

      $ cd installdir/apps/redmine/htdocs/
      $ bundle install --without development test postgresql sqlite --no-deployment
      $ bundle install --without development test postgresql sqlite --deployment
  • Install and migrate the Redmine Agile database:

      $ bundle exec rake redmine:plugins RAILS_ENV=production
      $ bundle exec rake redmine:plugins NAME=redmine_agile 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 services for the changes to take effect:

      $ sudo installdir/ restart
  • Sign in to your Redmine installation and navigate to the “Administration -> Agile” section to configure the new plugin.

  • Navigate to the “Projects -> PROJECT -> Settings -> Modules” menu to enable the Agile plugin in your project.

Last modification April 8, 2020