Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 84 lines (62 sloc) 2.032 kb
abad8b1 @markburns changing README to markdown for ease of reading on github, also some for...
markburns authored
1 Thin
2 ====
3
7108040 Added some things to read
macournoyer authored
4 Tiny, fast & funny HTTP server
5
26832b9 @macournoyer Fix typos
macournoyer authored
6 Thin is a Ruby web server that glues together 3 of the best Ruby libraries in web history:
abad8b1 @markburns changing README to markdown for ease of reading on github, also some for...
markburns authored
7
8 * the Mongrel parser: the root of Mongrel speed and security
9 * Event Machine: a network I/O library with extremely high scalability, performance and stability
10 * Rack: a minimal interface between webservers and Ruby frameworks
0e94568 @macournoyer update README
macournoyer authored
11
26832b9 @macournoyer Fix typos
macournoyer authored
12 Which makes it, with all humility, the most secure, stable, fast and extensible Ruby web server
13 bundled in an easy to use gem for your own pleasure.
b874f34 Update README, add security notice.
macournoyer authored
14
abad8b1 @markburns changing README to markdown for ease of reading on github, also some for...
markburns authored
15 Site: http://code.macournoyer.com/thin/
16 Group: http://groups.google.com/group/thin-ruby/topics
17 Bugs: http://thin.lighthouseapp.com/projects/7212-thin
18 Code: http://github.com/macournoyer/thin
19 IRC: #thin on freenode
805f638 @macournoyer Add EM 0.11 note in README too, aah well, isn't it out yet?!
macournoyer authored
20
abad8b1 @markburns changing README to markdown for ease of reading on github, also some for...
markburns authored
21 Installation
22 ============
c8e08b5 Typo fix on the site [gary].
macournoyer authored
23 For the latest stable version:
24
efcfc87 @markburns fixing some of formatting
markburns authored
25 ` sudo gem install thin `
c8e08b5 Typo fix on the site [gary].
macournoyer authored
26
27 Or from source:
ee53a91 Add a default config file
macournoyer authored
28
efcfc87 @markburns fixing some of formatting
markburns authored
29 ```
abad8b1 @markburns changing README to markdown for ease of reading on github, also some for...
markburns authored
30 git clone git://github.com/macournoyer/thin.git
31 cd thin
32 rake install
efcfc87 @markburns fixing some of formatting
markburns authored
33 ```
abad8b1 @markburns changing README to markdown for ease of reading on github, also some for...
markburns authored
34
ee53a91 Add a default config file
macournoyer authored
35
abad8b1 @markburns changing README to markdown for ease of reading on github, also some for...
markburns authored
36 Usage
37 =====
0e94568 @macournoyer update README
macournoyer authored
38 A +thin+ script offers an easy way to start your Rails application:
26832b9 @macournoyer Fix typos
macournoyer authored
39
efcfc87 @markburns fixing some of formatting
markburns authored
40 ```
abad8b1 @markburns changing README to markdown for ease of reading on github, also some for...
markburns authored
41 cd to/your/rails/app
42 thin start
efcfc87 @markburns fixing some of formatting
markburns authored
43 ```
26832b9 @macournoyer Fix typos
macournoyer authored
44
0e94568 @macournoyer update README
macournoyer authored
45 But Thin is also usable with a Rack config file.
46 You need to setup a config.ru file and pass it to the thin script:
47
abad8b1 @markburns changing README to markdown for ease of reading on github, also some for...
markburns authored
48 ```ruby
49 #cat config.ru
50 app = proc do |env|
51 [
52 200,
53 {
54 'Content-Type' => 'text/html',
55 'Content-Length' => '2'
56 },
57 ['hi']
58 ]
59 end
60
61 run app
62 ```
63
efcfc87 @markburns fixing some of formatting
markburns authored
64 ` thin start -R config.ru `
abad8b1 @markburns changing README to markdown for ease of reading on github, also some for...
markburns authored
65
0e94568 @macournoyer update README
macournoyer authored
66 See example directory for more samples and run 'thin -h' for usage.
b874f34 Update README, add security notice.
macournoyer authored
67
abad8b1 @markburns changing README to markdown for ease of reading on github, also some for...
markburns authored
68 License
69 =======
530be7d Refactor command line processor
macournoyer authored
70 Ruby License, http://www.ruby-lang.org/en/LICENSE.txt.
7108040 Added some things to read
macournoyer authored
71
abad8b1 @markburns changing README to markdown for ease of reading on github, also some for...
markburns authored
72 Credits
73 =======
35ec139 Update README to reflect last changes
macournoyer authored
74 The parser was stolen from Mongrel http://mongrel.rubyforge.org by Zed Shaw.
530be7d Refactor command line processor
macournoyer authored
75 Mongrel Web Server (Mongrel) is copyrighted free software by Zed A. Shaw
76 <zedshaw at zedshaw dot com> You can redistribute it and/or modify it under
77 either the terms of the GPL.
78
920f42e Add request tests from Mongrel and make them pass.
macournoyer authored
79 Thin is copyright Marc-Andre Cournoyer <macournoyer@gmail.com>
7108040 Added some things to read
macournoyer authored
80
766890e @macournoyer Doc fix and update README
macournoyer authored
81 Get help at http://groups.google.com/group/thin-ruby/
82 Report bugs at http://thin.lighthouseapp.com/projects/7212-thin
abad8b1 @markburns changing README to markdown for ease of reading on github, also some for...
markburns authored
83 and major security issues directly to a team member (see COMMITTERS)
Something went wrong with that request. Please try again.