Repository files navigation

A small and fast Ruby web server

gem install thin

Or addthin to yourGemfile:

gem'thin'

A +thin+ script offers an easy way to start your Rack application:

thin start

Browse theexample directory for sample applications.

Use a rackup (config.ru) file and bind to localhost port 8080:

thin -R config.ru -a 127.0.0.1 -p 8080 start

Store the server process ID, log to a file and daemonize:

thin -p 9292 -P tmp/pids/thin.pid -l logs/thin.log -d start

Thin is quite flexible in that many options can be specified at the command line (seethin -h for more).

You can create a configuration file usingthin config -C config/thin.yml.

You can then use it with all commands, such as:thin start -C config/thin.yml.

Here is an example config file:

---user:www-datagroup:www-datapid:tmp/pids/thin.pidtimeout:30wait:30log:log/thin.logmax_conns:1024require:[]environment:productionmax_persistent_conns:512servers:1threaded:trueno-epoll:truedaemonize:truesocket:tmp/sockets/thin.sockchdir:/path/to/your/apps/roottag:a-name-to-show-up-in-ps aux

Copyright, 2007-2025, by Marc-Andre Cournoyer and other contributors.

Released under the Ruby License, the 2-clause BSDL and the GNU General Public License (GPL) version 2 (or later). You can redistribute it and/or modify it under the terms of any of these licenses.

The parser was originally from Mongrelhttp://mongrel.rubyforge.org by Zed Shaw.Mongrel is copyright 2007 Zed A. Shaw and contributors. It is licensed underthe Ruby license and the GPL2.

Thin is copyright Marc-Andre Cournoyermacournoyer@gmail.com

Get help athttp://groups.google.com/group/thin-ruby/Report bugs athttps://github.com/macournoyer/thin/issuesand major security issues directly to me atmacournoyer@gmail.com.