1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88
|
# Thin
A small and fast Ruby web server
## Installation
```
gem install thin
```
Or add `thin` to your `Gemfile`:
```ruby
gem 'thin'
```
## Usage
A +thin+ script offers an easy way to start your Rack application:
```
thin start
```
Browse the `example` directory for sample applications.
### CLI
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 (see `thin -h` for more).
### Configuration files
You can create a configuration file using `thin 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:
```yaml
---
user: www-data
group: www-data
pid: tmp/pids/thin.pid
timeout: 30
wait: 30
log: log/thin.log
max_conns: 1024
require: []
environment: production
max_persistent_conns: 512
servers: 1
threaded: true
no-epoll: true
daemonize: true
socket: tmp/sockets/thin.sock
chdir: /path/to/your/apps/root
tag: a-name-to-show-up-in-ps aux
```
## License
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.
## Credits
The parser was originally from Mongrel http://mongrel.rubyforge.org by Zed Shaw.
Mongrel is copyright 2007 Zed A. Shaw and contributors. It is licensed under
the Ruby license and the GPL2.
Thin is copyright Marc-Andre Cournoyer <macournoyer@gmail.com>
Get help at http://groups.google.com/group/thin-ruby/
Report bugs at https://github.com/macournoyer/thin/issues
and major security issues directly to me at macournoyer@gmail.com.
|