TorqueBox 4 has replaced the need to have a TorqueBox Lite, since TorqueBox 4 is itself modular and light. If you're just interested in web bits, use the torquebox-web gem version 4.0.0.alpha1 or later.

http://torquebox.org/news/tags/4x/

No further releases of the torquebox-lite gem are planned.

TorqueBox Lite has a known incompatibility with Java 8, providing further motivation to migrate to torquebox-web instead.

This is a smaller, web-only version of TorqueBox. The main goal is to provide a reliable and maintained JRuby web server option with a small footprint and very simple usage. Scheduled jobs, messaging, Backgroundable, long-running services, distributed transactions, Infinispan caching, and clustering from TorqueBox will NOT work with TorqueBox Lite.

TorqueBox Lite is designed to only run a single application at a time - the application in the current directory. It creates a torquebox-lite directory inside this application to hold session data, temporary files, and server logs.

The underlying bits are identical to those in TorqueBox, except that many things have been removed. You can still create a torquebox.yml or torquebox.rb file to configure Ruby versions, environment variables, shared vs bounded JRuby pooling, web context, and various other things. See the TorqueBox documentation for more details there.

jruby -S gem install torquebox-lite

cd /path/to/your_app
torquebox-lite

Use CTRL+C to kill the foreground process. You can also use kill <pid> if you started it in the background.

If using Bundler, add torquebox-lite to your Gemfile instead of installing it via gem install and then run bundle exec torquebox-lite to boot the server.

touch $APP_ROOT/torquebox-lite/deployments/<app_name>-knob.yml.dodeploy

The app_name is usually the name of the application's directory - take a look at the other files under that deployments directory to see what it should be.

JRUBY_OPTS="--1.9" RAILS_ENV=production torquebox-lite

JRUBY_OPTS="-J-Xmx1024m" torquebox-lite

torquebox-lite -b 0.0.0.0 -p 3000

torquebox-lite --min-runtimes=3 --max-runtimes=5

torquebox-lite --help

Get in touch with us via the regular TorqueBox community channels - IRC, mailing lists, or Twitter.

Because TorqueBox Lite has a separate release cycle and codebase from TorqueBox itself, please use GitHub Issues to file bugs and feature requests instead of the TorqueBox JIRA.

Pull requests are more than welcome. There are really just two Ruby files that contain the majority of the code.

• build/assembly/bin/assemble.rb - Transform the stock TorqueBox distribution into our slimmed down version

• gems/torquebox-lite/bin/torquebox-lite - The torquebox-lite command which boots TorqueBox Lite

Building TorqueBox Lite requires Maven 3. From the project's root directory, just run mvn install.