faq.html.haml

---
title: FAQ 
layout: default
---

#right-sidebar
  #main-column
    :markdown
      # What is TorqueBox?
    
      TorqueBox is a small adaptation layer on top of Java application server from JBoss, [JBoss AS](http://jboss.org/jbossas/).
    
      It attempts to go beyond providing web-centric services (supporting Rails, Rack, Sinatra, etc),
      to also expose other enterprise-grade services to Ruby applications.
    
      # If it's a small layer, why is it a #{site.releases.first.dist_size}mb download?
    
      One goal of the TorqueBox distribution is a simplified end-user experience. 
      To accomplish this, the distribution includes a pre-integrated combination
      of the TorqueBox code, the base JBoss AS application server, and the full
      JRuby distribution, plus some useful gems such as Rails, Rack and Sinatra.
  
      The result is a #{site.releases.first.dist_size}mb distribution with everything you need (except for a JDK)
      right in the tin.

      **Note**: The next release of TorqueBox will be *much* smaller, as we will 
      no longer distribute Rack, Rails, and other gems.  You can simply grab them
      from RubyGems, of course.
    
      # Why is TorqueBox still in "beta"?
    
      TorqueBox is primarily developed by Bob McWhirter, the master of the perma-beta.
    
      Ultimately, the APIs are still shifting with each release, while we attempt
      to figure out the correct way to make the power of JBoss technologies available
      naturally to Rubyists.
    
      # Will TorqueBox ever support \[Python,Scala,Groovy,...\]
    
      Not directly, no.
    
      Of those, Python is the most interesting, and could certainly benefit
      from a similar initiative. 
    
      Scala, Groovy, and any other more Java-natural language already integrate
      pretty well with Java application servers, so what's there to do? 

      # How can I contribute to TorqueBox?

      Check out the multitude of resources available for our both our
      [user](/community/) and [development](/development/) communities.

      Your contributions to the code, this website, or the documentation
      are always appreciated.

      # 11?  What?

      Please see [Up to eleven](http://en.wikipedia.org/wiki/Up_to_eleven).

      # I'm getting deprecation warnings in my log about `*-rails.yml` and `*-rack.yml` file
    
      These files should now be named with the `*-knob.yml` format.  It is no longer
      necessary to encode your web framework in the filename.  So use `-knob.yml` instead.

      Please see [this article for more information](/news/2011/02/05/grand-unification-and-knobs/).

      # I'm getting deprecation warnings in my log about `jobs.yml` and other YAML files

      These files are mostly deprecated at this point, replaced by sections within
      a single `torquebox.yml` file.
      
      Please see [this article for more information](/news/2011/02/05/grand-unification-and-knobs/).

  #sidebar-column
    .box
      %h1 Unanswered questions?
      :markdown
        Try the [mailing lists](/community/mailing_lists/)!