Welcome to the wiki landing page for Drools. This site is for the project Drools - for information about the product (sometimes known as JBoss Rules or BRMS platform) - see here. Drools is the upstream project of the BRMS platform (as well as feeding into other platforms). Please feel free to add your own tips/gotchas - you just need to sign-up for a jboss.org account (free and open to everyone).


Events and up to date info

Please read and subscribe to the the blog. Upcoming events and latest news appear there, as well as articles and much more.


Getting help from the community

For user questions, please use the user list. There is also an IRC channel. This is volunteer best effort support. For guaranteed/SLA support, please refer to the BRMS platform.

Pre-installed Development environment for Virtual Box

Details on the virtual box image can be found here.



We are now running the excellent Hudson build tool. Whenever a change is made, it will build. You can track it from https://hudson.jboss.org/hudson/job/drools/. To get the latest SNAPSHOT releases, go to https://hudson.jboss.org/hudson/job/drools/lastSuccessfulBuild/artifact/trunk/target/. After a commit, a new build is usually available 30-ish minutes later (if successful), depending on load/time of day etc.






NOTE: There is also a complete manual for JBoss Drools, this wiki supplements the formal manual (see below for links).


Important links

Online documentation

Testing framework add-on

JBoss Rules Student Projects


Reporting Issues and Errors


Internationalization (i18n)

Help in translations is always welcome. Guvnor (the web console) is available in various languages thanks to volunteers..

See: Helping out with Guvnor i18n (how to translate GUI).



Getting help and helping out

  • As normal, the maniacs can be found in the drools IRC room at irc.codehaus.org. Web client available for those behind a firewall http://irc.codehaus.org. Mark Proctor is known as "conan", and he is a vegetarian, so he won't bite. The others are not though

  • Use the mailing lists. Use the "user" list for end user issues, "dev" for when you are mucking about with the internals.

  • Use jira to log issues.






From the download page there are samples to show of various aspects. Some samples may be found on the wiki from time to time which are more up to date/richer.



Drools Puzzles - (A Regular Drools Programming Contest)

Since August 2007 we have a regular programming contest for JBoss-Drools. Initiated by E.Zhao, open to everyone. See the JBoss-Drools puzzle page for details. You might even win a price...





Drools Research Network

Drools is used in a number of research projects in various universities, this page attempts to list some of these and provides details on the mailing list for academic collaborative efforts.



TIPS, TRICKS & FAQ for users (rule developers)





Rule patterns and practices



Tips for JBoss Rules developers/contributors




Miscellaneous Questions


Presentations (feel free to use as needed)

Maven2 Repository

JBoss Rules is made available at the JBoss maven2 repository http://repository.jboss.com/maven2/ in the following directory http://repository.jboss.com/maven2/org/drools/. We do not currently upload to ibiblio, but community members are welcome.


Wiki guidelines

  • Feel free to edit/add to this wiki - the aim of the wiki is not to be a manual, but to be a general "catch all" area for helpful tips and links. Also, articles and documentation may be entered here first, when its ready, it will then be formally moved into the manual for future reference. In the old Drools web site, the wiki was also the documentation, but for Drools 3 onwards, we are providing a formal manual for this purpose.

  • Many tips are from real world deployments, add more of your own  Feedback/contributions are always appreciated. Its a wiki !



.Net version

  • Information can still be located here



Design and Enhancement ideas

This section is for contributors (of ideas and code) or people interested in the future directions of JBoss Rules. Some of these ideas are works well in progress, some are just concepts/thoughts. Jump in, the water is warm (its a wiki !).

BRMS (repository) designs

Rule Deployment Agent

DSLs, Natural Language and rules

SBVR standard (s beaver)



Event Stream Analysis




Backward  Chaining






Decision tables: