Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
A project to use Yaws and Rack to provide a high performance environment for running Rack applications.
Erlang Ruby
Branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
conf
ebin
src
test
.gitignore
.rvmrc
Gemfile
LICENSE
Makefile
README.md

README.md

Yars

http://github.com/mclaughlin77/yars

By Kelly McLaughlin

Tip O' The Hat: Fuzed authors Dave Fayram, Tom Preston-Werner, and Abhay Kumar

Description

Yars provides a means to use the high performance Erlang webserver Yaws to serve rack applications in the same vein as Phusion Passenger. The main goals of this project are performance and simplicity. Yars strives to be simple to install, configure, and use so developers can spend more time writing applications.

Dependencies

Install

Clone the yars repo.

git clone http://github.com/mclaughlin77/yars.git

The master branch will always track the latest release.

Next, enter the yars directory and run make to build the erlang project files.

Finally add any gems your rack-based project requires to the Gemfile and run: bundle install

This will install all the gems needed by yars and your project into the yars gemset.

That's it. Yars should be ready to configure and run.

Configuration

Copy the conf/sample.conf file to use a template. Many of the configuration directives are self-explanatory so I'll only cover a few here.

  • Create a server block for each application you want to serve. Replace localhost with the domain name for the application.
  • docroot - Change docroot to point to the public directory of your project.
  • request_pool_size - This is the number of ruby workers that yars will start and use to fulfill requests.
  • request_wait_threshold - The amount of time in milliseconds that pending requests for a particular ruby instance will wait for it to finish its current processing task before being distributed to another member of the request pool.

Copyright

Copyright (c) 2010 Kelly McLaughlin. See LICENSE for details.

Something went wrong with that request. Please try again.