1
0
Fork 0
mirror of https://github.com/puma/puma.git synced 2022-11-09 13:48:40 -05:00
A Ruby/Rack web server built for parallelism
Find a file
Evan Phoenix e5e993bd85 Merge pull request #19 from headius/master
Updates for JRuby
2011-11-22 12:32:23 -08:00
bin Simplify, remove GemPlugin usage 2011-09-27 09:23:03 -07:00
examples Deprecated obsolete Windows service scripts. 2009-07-07 03:42:29 -03:00
ext/puma_http11 First pass updating JRuby bits for Puma. 2011-11-22 13:43:54 -06:00
lib Handle not exposing the next request to the last one 2011-11-22 11:51:59 -08:00
tasks First pass updating JRuby bits for Puma. 2011-11-22 13:43:54 -06:00
test Merge pull request #19 from headius/master 2011-11-22 12:32:23 -08:00
tools minor test cleanups 2007-10-21 02:54:53 +00:00
.gitignore Ignore rubinius compiled files. 2010-04-28 20:30:21 -03:00
COPYING Ruby license applied to all files 2006-06-30 20:42:12 +00:00
Gemfile Add rdoc and rake-compiler as gems 2011-10-22 23:17:29 -07:00
History.txt That was too early, revert to 1.2.0.beta.1 instead. 2010-07-24 14:04:12 -03:00
LICENSE Update license 2011-09-23 20:27:54 -07:00
Manifest.txt rename to puma_http11 2011-10-22 07:42:54 +08:00
puma.gemspec Add rack as a dep 2011-10-25 15:07:54 -07:00
Rakefile Start cleanup and modernization 2011-09-15 13:23:36 -07:00
README.md Add documentation for Rails/Sinatra/Rack usage 2011-10-25 14:29:38 -07:00
README.txt Add timeout support to persistent connections 2011-10-04 21:11:10 -07:00
TODO oops... gems is quite necessary 2007-11-01 06:14:56 +00:00

Puma: A Ruby Web Server Built For Concurrency

Description

Puma is a small library that provides a very fast and concurrent HTTP 1.1 server for Ruby web applications. It is designed for running rack apps only.

What makes Puma so fast is the careful use of an Ragel extension to provide fast, accurate HTTP 1.1 protocol parsing. This makes the server scream without too many portability issues.

License

Puma is copyright 2011 Evan Phoenix and contributors. It is licensed under the BSD license. See the include LICENSE file for details.

Quick Start

The easiest way to get started with Puma is to install it via RubyGems and then run a Ruby on Rails application. You can do this easily:

$ gem install puma

Now you should have the puma command available in your PATH, so just do the following:

$ puma app.ru

Install

$ gem install puma

Advanced Setup

Sinatra

You can run your Sinatra application with Puma from the command line like this:

$ ruby app.rb -s Puma

Or you can configure your application to always use Puma:

require 'sinatra'
configure { set :server, :puma }

If you use Bundler, make sure you add Puma to your Gemfile (see below).

Rails

First, make sure Puma is in your Gemfile:

gem 'puma'

Then start your server with the rails command:

$ rails s puma

Rackup

You can pass it as an option to rackup:

$ rackup -s puma

Alternatively, you can modify your config.ru to choose Puma by default, by adding the following as the first line:

#\ -s puma