This guide explains how to install the Redmine+ Automation Plugin on a self-hosted Redmine server.

1) Prepare your environment

Before installing, confirm:

  • You have shell access to the Redmine server
  • You can run commands as a user with permissions for the Redmine directory
  • Your Redmine version is compatible with the plugin version

2) Upload plugin package

Place the plugin zip in your Redmine plugins directory.

Terminal window
cp /path/to/downloads/redmine_plus_automation.zip /path/to/redmine/plugins/
cd /path/to/redmine/plugins
unzip redmine_plus_automation.zip

3) Install dependencies

From the Redmine root:

Terminal window
cd /path/to/redmine
bundle install

4) Run plugin migrations

Terminal window
bundle exec rake redmine:plugins:migrate RAILS_ENV=production

5) Restart Redmine

For Passenger:

Terminal window
touch /path/to/redmine/tmp/restart.txt

For systemd-managed app servers:

Terminal window
sudo systemctl restart redmine

6) Enable scheduled automations (Linux cron)

Scheduled triggers require a cron job. Edit crontab:

Terminal window
crontab -e

Add:

Terminal window
*/5 * * * * cd /path/to/redmine && RAILS_ENV=production bundle exec rails runner "AutomationRunScheduledTriggersJob.perform_now" >> log/cron_automation.log 2>&1

This runs the scheduler every 5 minutes.

7) Verify installation

  1. Log in as admin
  2. Go to Administration -> Plugins
  3. Confirm Redmine Automation appears and is enabled

Troubleshooting checklist

  • Plugin not visible: verify plugin folder name and server restart.
  • Bundle errors: run bundle install in Redmine root.
  • Migration errors: check DB credentials in config/database.yml.
  • Scheduled rules not running: verify cron service and log/cron_automation.log.

Next steps