Plugins Directory » Knowledgebase

Author: Alex Bevilacqua
Code repository:
Registered on: 2010-11-17 (over 13 years ago)
Current version: 3.2.1
Compatible with: Redmine 3.2.x, 3.1.x, 3.0.x, 2.6.x, 2.5.x, 2.4.x
User ratings:   (18)

This plugin adds generic knowledgebase funcationlity to the redmine project management application.


The plugin is available in two versions, which track the Redmine versions to reflect their level of compatibility. If you're using Redmine 1.x.x, use a 0.x.x or 1.x.x version of the Knowledgebase; if you're using Redmine 2+, use a Knowledgebase version >= 2.

Installation notes

full installation instructions are available at


3.2.1 (2016-08-16)

Compatible with Redmine 3.2.x, 3.1.x, 3.0.x, 2.6.x, 2.5.x, 2.4.x.

  • fixes search in 3.2.x
  • updated RU locale

3.2.0 (2016-06-22)

Compatible with Redmine 3.2.x, 3.1.x, 3.0.x, 2.6.x, 2.5.x.

(Pre-release: Searching broken)

Thanks to Frederico Camara:

  • updating acts_as_rated to work with Redmine 3.2.x

Thanks to Eduard Kuleshov:

  • getting this plugin supported in Redmine 3.0.x

Thanks to Axel Kämpfe:

  • getting this plugin supported in Redmine 3.1.x and 3.2.x

HUGE thanks to Rob Spearman for basically taking over the project and pushing it forward:

  1. New Configuaration options
  • Show articles without tabs
  • Show attachments before article content
  • Show thumbnails for articles in lists
  • Show breadcrumbs for articles in lists
  1. New permissions
  • Article history will only show up if have view permission
  • optional permission for users to manage just their own articles. (#306)
  1. Layout
  • Sort Tags on the index page
  • Added authored view so users can find articles by author easily
  1. Bug Fixes
  • article view counts not updating (#304)
  • top rated list not valid (#305)
  • ActiveRecord::StaleObjectError (Attempted to destroy a stale object: KbArticle) (#300)
  • Error when generating a PDF of an article with pictures (#308)
  • 500 Internal Server Error - if DELETE category but it's have subcategory (#293)

3.1.0 (2015-12-03)

Compatible with Redmine 3.1.x, 3.0.x.

Finally merged the 3.0-compat branch into master ;)

This is the first release that support Redmine 3.0 and above.

3.0.7 (2014-12-15)

Compatible with Redmine 2.5.x, 2.4.x, 2.3.x, 2.2.x.

  • fixes the undefined methodversion_comments=' for #KbArticle::Version:...` bug
  • fixed star ratings for Redmine 2.6+ (even though those versions aren't officially supported yet)

3.0.6 (2014-11-10)

Compatible with Redmine 2.5.x, 2.4.x, 2.3.x, 2.2.x.

  • store remote ip (instead of remote_addr) when viewing an article
  • updated DE, ZH, ES and PL localizations

3.0.5 (2014-07-24)

Compatible with Redmine 2.5.x, 2.4.x, 2.3.x, 2.2.x, 2.1.x.

  • updated Japanese translation
  • added a Hungarian translation
  • fixed attachment deletion in articles
  • fixed link_to_remote version test
  • format knowledgebase title on index page so it looks a bit nicer with some themes

3.0.4 (2014-04-07)

Compatible with Redmine 2.5.x, 2.3.x, 2.2.x.

This point release fixes an issue with some other plugins (ex: Redcase) that also mix functionality into the Redmine Project model.

3.0.3 (2014-03-18)

Compatible with Redmine 2.5.x, 2.4.x, 2.3.x, 2.2.x.

  • fixed a security issue involving cross-project access of articles and categories
  • remove Ruby 2 hash syntax to ensure backwards compatibility
  • updated localizations (FR, DE)
  • new localizations (NL)
  • fixed tag sorting
  • fixed 'undefined link_to_article' error
  • fix casting error with summary_limit settings value

Download from

3.0.2 (2014-01-28)

Compatible with Redmine 2.4.x, 2.3.x, 2.2.x, 2.1.x.

  • minor bug fixes and cleanup
  • updated German translations
  • fix an issue with the admin settings interface for the knowledgebase

3.0.1 (2014-01-23)

Compatible with Redmine 2.5.x, 2.4.x, 2.3.x, 2.2.x.

  • Updated Japanese localization
  • Updated German localization
  • Updated README to include clear upgrade process from v2.3.0 to v3.0.0
  • "Properly" include dynamic components (in init.rb) using ActionDispatch::Reloader.to_prepare
  • Fixed an issue with uninitialized plugin settings causing crashes

3.0.0 (2014-01-10)

Compatible with Redmine 2.4.x, 2.3.x, 2.2.x, 2.1.x, 2.0.x.

Happy New Year everyone!

To kick things off, I'm releasing the first iteration of the 3.x branch of the redmine_knowledgebase.

This release changes the plugin focus from being "pseudo-global" to project-based, and as such will require existing knowledgebases to be "massaged" slightly in order to get them to work (basically just ensuring a valid project_id is set for categories/articles).

As this is a major update, I anticipate there may be some initial issues. Please feel free to report any difficulties on the project page at

Download from

2.3.0 (2013-06-25)

Compatible with Redmine 2.4.x, 2.3.x, 2.2.x.

  • move tagging functionality to redmine_acts_as_taggable_on
  • make preview functionality Redmine-version tolerant
  • honour anonymous settings when trying to view content


2.2.0 (2012-10-31)

Compatible with Redmine 2.3.x, 2.2.x, 2.1.x, 2.0.x.

Changes since 2.1.0
  • article preview now uses core modal functionality (dropped facebox)
  • fixed article ratings with new ratings system
  • fixed link_to_remote issues
  • fixed wiki macros issue
  • fixed category deletion
  • updated Russian translation
  • updated French translation
  • added Korean translation
  • added Greek translation

2.1.0 (2012-06-28)

Compatible with Redmine 2.0.x, 2.1.x.

  • lots of bugfixes
  • added Turkish translation
  • updated tagging suport (so it should actually work now)

NOTE This release drops the old (builtin) tagging library and instead uses the acts-as-taggable-on gem, so back up your database if upgrading (just in case).

1.0.0 (2012-06-28)

Compatible with Redmine 1.0.x, 1.1.x, 1.2.x, 1.3.x, 1.4.x.

  • finally promote the plugin to a stable version
  • added a Turkish translation
  • fix to allow proper uninstallation of the plugin

2.0.0 (2012-06-14)

Compatible with Redmine 2.0.x.

Initial release that supports Redmine >= 2

0.4.0 (2012-06-14)

Compatible with Redmine 1.2.x, 1.3.x, 1.4.x.

should now work properly with 1.4.x

0.3.3 (2012-02-14)

Compatible with Redmine 1.0.x, 1.1.x, 1.2.x, 1.3.x.

  • fixed acts-as-taggable-on dependency hell (hopefully once and for all)
  • fixed routing to work with Redmine 1.3+

0.3.2 (2012-01-02)

Compatible with Redmine 1.0.x, 1.1.x, 1.2.x.

  • added configuration option for number of articles to summarize in knowledgebase#index
  • added a wiki macro for knowledgebase articles
  • added Czech translation
  • added Japanese translation
  • added a tag cloud to the knowledgebase#index
  • fixed routing for redmine 1.3+
  • updated acts-as-taggable-on dependency
redmine_knowledgebase-v0.3.2.tar.gz (55.9 KB) redmine_knowledgebase-v0.3.2.tar.gz Alex Bevilacqua, 2012-01-02 18:31

0.3.1 (2011-05-20)

Compatible with Redmine 1.0.x, 1.1.x, 1.2.x.

  • added Polish translation
  • localized the top menu entry
  • added Spanish translation
  • properly filter the main page's new/updated/toprated/popular items
  • added a plugin configuration panel
  • use proper link authentication helpers for acticles/categories
  • allow anonymous access to the knowledgebase (read-only) based on the setting in the configuration panel (default => true)
  • cleanup category list on the main page
  • fixed comment creation popup not being displayed

0.3.0 (2011-05-10)

Compatible with Redmine 1.0.x, 1.1.x, 1.2.x.

This release includes the permissions update, a handful of new localizations and bugfixes.

0.2.5 (2010-06-11)

Compatible with Redmine 0.9.x, 1.0.x, 1.1.x.

User ratings

  by Thomas Chine over 7 years ago

thanks all authors first, I like it.
this plugins worked well in a server installed redmine 2.4.
But today I installed one redmine version 3.3.0, raise a error on installing this plugin. anyone test or use this plugin in redmine V3.3.0?

  by T Iwan almost 8 years ago

Very cool.
Thank you.

  by Dariel rodriguez about 8 years ago

  by mathew murphy over 8 years ago

Still works on RedMine 3.2.

  by sugeng tigefa over 8 years ago

  by André Lozovey about 9 years ago

  by Maicon Zucco about 9 years ago

Great plugin!

  by Nguyen Ba Tan about 9 years ago

OK redmine 2.6

  by Mario Luzeiro over 9 years ago

Alex is giving support to this plugin for more than 4 years now showing his dedication to plugin, keeping it alive. This plugin does its job and is very simple to use.

  by mike B over 9 years ago

Very simple. Perfect. Only been using it for 30 minutes and have already created a better KB than what we have on our server...suggestions: add the ability to "mention" or link other articles within articles and also a collapsible tree view for categorie

  by Changsheng Gu over 9 years ago

  by m mahdi over 9 years ago

  by Chad West over 9 years ago

By far one of my favorite plugins.

  by Sam Razor almost 10 years ago

  by Robert Schneider almost 10 years ago

Works perfect! However, it would be nice if the structure is more focused. Not the highest rated, most popular and last edited files. Those information is less important, they could be on the right side.

  by Marco Lima almost 10 years ago

  by Dipan Mehta about 10 years ago


  by Jonas Götze about 10 years ago