Skip to content

Latest commit

 

History

History
46 lines (30 loc) · 1.32 KB

INSTALL.md

File metadata and controls

46 lines (30 loc) · 1.32 KB

Requirements

You need ruby 1.8.6 or above and rubygems installed.

Installation

Use following command to install runit-man:

gem install runit-man

Take a look at runit-man script options:

  • -p - Port to listen (4567 by default)
  • -b - IP Address to bind (0.0.0.0 by default)
  • -a - Directory of activated services (/etc/service by default)
  • -f - Directory of all known services (/etc/sv by default)
  • -u - User and password delimited by ':' for HTTP authentication (disabled by default)
  • -r - Register runit-man as runit service (as defined by other options)
  • --rackup='command' - Runs specified command in folder where is runit'man's config.ru located.

Using thin

Usually you need thin gem to run runit-man effectively.

gem install thin

Using rainbows

When You need to handle large files (logs etc.) by runit-man script You need another setup:

  • Install rainbows gem (it prevents memory consumption).
  • Install sendfile gem if possible (It decreases CPU usage in combination with rainbows).
  • Run runit-man as:
runit-man --rackup='rainbows -E production -c rainbows.conf -p $PORT'

Using runit-man cookbook

We provide runit-man cookbook to automate setup of runit-man using Opscode Chef.