RedmineX Project Templates Plugin

The RedmineX Project Templates Plugin eliminates repetitive setup by allowing you to launch fully configured projects in under 30 seconds. With one-click cloning, you can standardize your workflows by reusing entire project structures, including tasks, milestones, custom fields, role permissions, and issue relations. Designed to turn Redmine into a high-speed delivery machine, the plugin offers advanced template control and seamless compatibility with Agile and Gantt tools, ensuring every new project starts with the right structure while remaining flexible enough for on-the-fly adjustments.

Installation


1. Go To Root & Unzip

Unzip the archive and upload the folder redmine_x_project_templates to redmine_root/plugins or upload the archive in the same location and perform the unzip command in the console. Do NOT change the plugin folder name.

2. Install Gems

From redmine_root run bundle install. No need for any migration (rake).

If the gems were installed correctly, this is roughly what you should see.

Bundle complete! 45 Gemfile dependencies, 74 gems now installed.

Gems in the groups development and test were not installed.

Use `bundle info [gemname]` to see where a bundled gem is installed.

3. Migrate

When installing Redmine X Project Templates plugin, you need to run the migration command bundle exec rake redmine:plugins:migrate RAILS_ENV=production.

If the migration went well, this is roughly what you should see.

4. Restart

Restart Redmine. Based on your hosting provider / web server, you will need to run the following commands. Puma: sudo systemctl restart redmine.yourcompany.com.service or Passenger: touch tmp/restart.txt.

5. Project Template Permissions

Project templates inherit permission from the project. If you want to edit the permissions, go to ~/roles and change permissions in the Project section.

6. For Redmine 6.x+ Only

If you are using Redmine 6+, make sure the theme is present in redmine_root/themes/redminex_theme/.

Then:

  1. Ensure correct permissions: chmod -R 755 redmine_root/themes/redminex_theme

  2. Clear cache: rm -rf tmp/cache

  3. Precompile assets (if you're in production mode): bundle exec rake assets:precompile RAILS_ENV=production

  4. Restart Redmine

How to Upgrade


1. Go To /plugins

Remove the redmine_x_project_templates folder and upload the unziped folder of the new version. Alternatively, you can copy the archive in the same location and perform the unzip command in the console.

2. Removing Leftovers

Make sure you also removed any leftovers located in /public/plugin_assets - delete the redmine_x_project_templates folder.

3. Install Gems

From redmine_root run bundle install.

4. Migrate

When updating Redmine X Project Templates plugin, you need to run the migration command bundle exec rake redmine:plugins:migrate RAILS_ENV=production.

5. Restart

Restart Redmine. Based on your hosting provider / web server, you will need to run the following commands. Puma: sudo systemctl restart redmine.yourcompany.com.service or Passenger: touch tmp/restart.txt.

Usage & Plugin Features


Need Assistance?

If you encounter any issues or need help with installation, updates, or configuration, no worries, just contact Denis at HelpDesk. Our support team is ready to help you with any trouble or questions.