THIN(1)

hey bestie 💖 welcome to the thin page — yes, section 1, user commands, the whole vibe. thin is that girl: a web server for Ruby that is fast and extremely not complicated. Let's get into it 🫶

---

🌸 NAME 🌸

thin — fast and very simple Ruby web server ✨

---

🎀 SYNOPSIS 🎀

thin [options] start|stop|restart|config|install

like… you pick your options, then you tell it what to do. iconic behavior honestly 💅

---

✨ DESCRIPTION ✨

okay so here's the whole menu of options, grouped by vibe. every single one, no skips, we're not doing that here 🍓

🖥️ Server options

• -a, --address HOST — bind to the HOST address (default: 0.0.0.0)
• -p, --port PORT — use PORT (default: 3000)
• -S, --socket FILE — bind to a unix domain socket
• -y, --swiftiply [KEY] — run using swiftiply
• -A, --adapter NAME — which Rack adapter to use (default: autodetect) — your choices are rack, rails, ramaze, merb, file
• -R, --rackup FILE — load a Rack config file instead of a Rack adapter
• -c, --chdir DIR — change to dir before starting
• --stats PATH — mount the Stats adapter under PATH

🔒 SSL options

• --ssl — enables SSL
• --ssl-key-file PATH — path to private key
• --ssl-cert-file PATH — path to certificate
• --ssl-disable-verify — disables (optional) client cert requests
• --ssl-version VERSION — TLSv1, TLSv1_1, TLSv1_2
• --ssl-cipher-list STRING — example: HIGH:!ADH:!RC4:-MEDIUM:-LOW:-EXP:-CAMELLIA

🧩 Adapter options

• -e, --environment ENV — framework environment (default: development)
• --prefix PATH — mount the app under PATH (start with /)

🌙 Daemon options

• -d, --daemonize — run daemonized in the background
• -l, --log FILE — file to redirect output (default: /build/thin-1XBQn3/thin-1.8.2+git20250216.de6b618/log/thin.log)
• -P, --pid FILE — file to store PID (default: tmp/pids/thin.pid)
• -u, --user NAME — user to run daemon as (use with -g)
• -g, --group NAME — group to run daemon as (use with -u)
• --tag NAME — additional text to display in process listing

👯 Cluster options

• -s, --servers NUM — number of servers to start
• -o, --only NUM — send command to only one server of the cluster
• -C, --config FILE — load options from config file
• --all [DIR] — send command to each config files in DIR
• -O, --onebyone — restart the cluster one by one (only works with the restart command)
• -w, --wait NUM — maximum wait time for server to be started in seconds (use with -O)

⚡ Tuning options

• -b, --backend CLASS — backend to use, full classname
• -t, --timeout SEC — request or command timeout in sec (default: 30)
• -f, --force — force the execution of the command
• --max-conns NUM — maximum number of open file descriptors (default: 1024). might require sudo to set higher than 1024 👀
• --max-persistent-conns NUM — maximum number of persistent connections (default: 100)
• --threaded — call the Rack application in threads [experimental]
• --threadpool-size NUM — sets the size of the EventMachine threadpool. (default: 20)
• --no-epoll — disable the use of epoll

🌈 Common options

• -r, --require FILE — require the library
• -q, --quiet — silence all logging
• -D, --debug — enable debug logging
• -V, --trace — set tracing on (log raw request/response)
• -h, --help — show this message
• -v, --version — show version

bestie the --threaded flag is experimental, ok? treat it with respect 🙈

---

👀 SEE ALSO 👀

the full documentation for thin is maintained as a Texinfo manual 📚 so if the info and thin programs are properly installed at your site, this command:

info thin

should give you access to the complete manual. literally the whole thing, no cap ✨

---

and that's the whole page!! 💜 this is thin version 1.8.2, codename Ruby Razor, dated February 2026. go off, run your little Ruby server, you're the main character now 👑🌈 🦋