Fetching contributors…
Cannot retrieve contributors at this time
74 lines (45 sloc) 1.93 KB


  • Maven 3
  • Configuration of the JBoss Maven repository in settings.xml


Install the project using the provided settings.xml:

mvn -s build-support/settings.xml install

If you will be building the project often, you'll want to create/modify your own ~/.m2/settings.xml file.

If you're a regular JBoss developer, see:

Otherwise, see:

Once your repositories are configured, simply type:

mvn install


  • build-support/ Contains code related to building TorqueBox, but not involved at runtime.

  • components/ Includes all code required at runtime within the AS (Java-centric).

  • containers/ Includes outside-of-the-AS container code (Ruby-centric).

  • clients/ Includes client API gems (Ruby-centric).

  • assemblage/ Contains instructions for building the assembled final deliverables and distributions.

  • integration-tests/ Contains a series of Arquillian-based tests against the packaged distribution.

  • dist/ Contains the instructions for creating the final binary distributable in .zip format.

Development Tips

If you're actively developing portions of the TorqueBox codebase, it's useful to define $TORQUEBOX_HOME around the directory


And then define JBOSS_HOME and JRUBY_HOME per usual


This assembly is created when you execute mvn install from the top-level project.

As you built integration projects using mvn install, they will install themselves into the assembly, if present. Likewise, dependency gems will be installed into the JRuby RubyGems path. Plus, changes to the VFS system will install itself into the JRuby lib directory and gem repository as-needed.

It's like magic.