Thin

Tiny, fast & funny HTTP server

Thin is a web server written entirely in Ruby in the simplest way possible. It does as little as possible to serve your Rails application, which makes it one of the fastest Rails server out there.

Installation

For the latest stable version:

sudo gem install thin

For the risky but so much cooler alpha version:

sudo gem install thin --source http://code.macournoyer.com

Or from source:

svn co http://code.macournoyer.com/svn/thin/trunk thin
cd thin
rake install

Usage

In your Rails app directory:

thin start

See code.macournoyer.com/thin/doc/files/bin/thin.html

Deployment

To deploy your Rails application using a cluster of thin servers. You can start it with:

thin_cluster start

To use the Capistrano recipes, add this to your Capfile:

require 'thin'
require 'thin/recipes'

and create a config file using:

thin_cluster config

See code.macournoyer.com/thin/doc/files/bin/thin_cluster.html

Security

Thin should never be used facing the internet directly, it should always be hidden behind a proxy server!

Thin is faster because it doesn’t do a lot of things that other Ruby web servers do (use threads, validate the body length, be very strict about the request format, etc.) but that a good proxy server do very well (and a lot faster then any Ruby code could possibly do). So it is very important that you setup you proxy server correctly in order to secure Thin from potential attacks.

Nginx comes with everything you need and can be used securely out of the box with thin.

Apache mod_proxy is not secure because it doesn’t cache the request before sending it to the backend, which open your server to easy DoS attacks. You need to install mod_accel (sysoev.ru/en/) to make mod_proxy behave like Nginx on that side.

License

Ruby License, www.ruby-lang.org/en/LICENSE.txt.

Credits

Lots of the code was inspired (or stolen entirely) from Mongrel mongrel.rubyforge.org by Zed Shaw. Mongrel Web Server (Mongrel) is copyrighted free software by Zed A. Shaw <zedshaw at zedshaw dot com> You can redistribute it and/or modify it under either the terms of the GPL.

transat/parser.rb was taken from Piston source code. Copyright © 2006 Francois Beausoleil <[email protected]>

Thin is copyright Marc-Andre Cournoyer <[email protected]>

Please report any bug at code.macournoyer.com/thin/trac.fcgi/newticket