Runs a rack conform application inside jetty web server
Ruby Java
Latest commit 181bd49 May 28, 2013 @geekq Merge pull request #8 from erdeszt/master
Fixing a bug when debug is enabled
Failed to load latest commit information.
bin refactored to be a little bit more concise Feb 8, 2011
examples Documentation and example for pid option Feb 19, 2013
jars Removing the old jruby-rack jar. Dec 19, 2012
lib Removing undefined variable and simplifying the debug logic May 28, 2013
.gitignore Switch from jeweller to pure bundler for gem packaging Dec 30, 2012
Gemfile Switch from jeweller to pure bundler for gem packaging Dec 30, 2012
LICENSE.txt Switch from jeweller to pure bundler for gem packaging Dec 30, 2012
Rakefile Switch from jeweller to pure bundler for gem packaging Dec 30, 2012
jetty-rackup.gemspec Packaging, including the main jetty-rackup, works Dec 30, 2012



For the newer projects we decided to switch from MRI to JRuby. One of the bigger questions is certainly the deployment.

Reading and trying all the warbler stuff, we had enough of packaging and wanted to do it the Ruby/Sinatra way (with a standalone script, where one can consciously start things like run Sinatra::Application from a rackup script).

Embedding jetty is also mentioned in the jetty documentation "For many applications, HTTP is just another interface protocol. Jetty can easily be embedded in such applications and products without adopting a WWW centric application architecture."

So here is the solution:

  • write your Rack based application as usual
  • create a rackup script as usual; there is more information in the official tutorial
  • install jetty-rackup (this project), e.g. gem install jetty-rackup or git clone git://
  • from your application folder run jetty-rackup. You can also provide a path to non-standard rackup-script and the desired port number for the server to run.

Now your application runs inside jetty servlet container. Enjoy!



#\ -p 8765
require 'rubygems'
gem 'sinatra', '>= 1.0.0'
require './my_app.rb'
set :run, false # disable built-in sinatra web server
set :environment, :development
set :base_url, 'http://xxtrial' # custom application option
run Sinatra::Application


The jetty and jruby-rack binaries are now provided for your convinience. But you can also download a different version of them, if you wish, from the official web sites of the respective projects:

The major gem version (7) now matches the used jetty version.


What's the best way to set max memory?

jruby -J-Xmx2048m  /usr/local/lib/jetty-rackup/jetty-rackup


There are no automated tests for jetty-rackup. But there are some example applications with rackup configuration. Just cd to the particular example directory and run. E.g.

cd examples/just_ruby/
firefox http://localhost:9292/stranger

jetty-rackup uses file from the current directory by default.

What's new

  • 7.2.0
    • Add support for Host option. In addition to specifying port now a host ip can also be specified if e.g. you only wish to bind the server only to the loopback interface and not to all IPs.
    • Add support for pid option - create pid file

See also

For Rails deployment you may prefer jetty-rails


(c) 2009 Vodafone Group Services GmbH

(c) 2013 Vladimir Dobriakov


Vladimir Dobriakov,

With contributions by Leandro Silva, Jason Rogers and erdeszt.

Further Credits