README

   1 == Thin
   2 Tiny, fast & funny HTTP server
   3
   4 Thin is a Ruby web server that glues together 3 of the best Ruby libraries in web history:
   5  * the Mongrel parser: the root of Mongrel speed and security
   6  * Event Machine: a network I/O library with extremely high scalability, performance and stability
   7  * Rack: a minimal interface between webservers and Ruby frameworks
   8 Which makes it, with all humility, the most secure, stable, fast and extensible Ruby web server
   9 bundled in an easy to use gem for your own pleasure.
  10
  11 === Installation
  12 For the latest stable version:
  13
  14  sudo gem install thin
  15
  16 or using my mirror (might be more recent):
  17
  18  sudo gem install thin --source http://code.macournoyer.com
  19
  20 Or from source:
  21
  22  git clone git://repo.or.cz/thin.git
  23  cd thin
  24  rake install
  25
  26 === Usage
  27 A +thin+ script is offered to easily start your Rails application:
  28
  29  cd to/your/rails/app
  30  thin start
  31
  32 But Thin is also usable through Rack +rackup+ command.
  33 You need to setup a config.ru file and require thin in it:
  34
  35  cat <<EOS
  36  require 'thin'
  37
  38  app = proc do |env|
  39   [200, {'Content-Type'=>'text/html'}, ['hi']]
  40  end
  41
  42  run app
  43  EOS
  44  rackup -s thin
  45
  46 See example/config.ru for details and rackup -h
  47
  48 === License
  49 Ruby License, http://www.ruby-lang.org/en/LICENSE.txt.
  50
  51 === Credits
  52 The parser was stolen from Mongrel http://mongrel.rubyforge.org by Zed Shaw.
  53 Mongrel Web Server (Mongrel) is copyrighted free software by Zed A. Shaw
  54 <zedshaw at zedshaw dot com> You can redistribute it and/or modify it under
  55 either the terms of the GPL.
  56
  57 Thin is copyright Marc-Andre Cournoyer <macournoyer@gmail.com>
  58
  59 Please report any bug at http://groups.google.com/group/thin-ruby/
  60 and major security issues directly to me at macournoyer@gmail.com.