Skip to content


Subversion checkout URL

You can clone with
Download ZIP
tag: v0.2.0
Fetching contributors…

Cannot retrieve contributors at this time

55 lines (35 sloc) 1.577 kb


Rack:GridFS is a Rack middleware for creating HTTP endpoints for files stored in MongoDB's GridFS. You can configure a prefix string which will be used to match the path of a request and create a key for looking up the file in the GridFS store.

For example,

GET '/gridfs/images/foo.jpg'

If the prefix is “gridfs”, then the key will be be “images/foo.jpg”.


  • ActiveSupport (activesupport)

  • Mongo Ruby Driver v0.15.1+ (mongo)


sudo gem install skinandbones-rack-gridfs --source=


require 'rack/gridfs'
use Rack::GridFS, :hostname => 'localhost', :port => 27017, :database => 'test', :prefix => 'gridfs'

You must specify MongoDB database details:

  • hostname: the hostname/IP where the MongoDB server is running. Default 'localhost'.

  • port: the port of the MongoDB server. Default 27017.

  • database: the MongoDB database to connect to.

  • prefix: a string used to match against incoming paths and route to through the middleware. Default 'gridfs'.


This is an experimental project. The Ruby GridFS adaptor is still pretty new and the performance is known to be slow. I wouldn't recommend using this middleware for anything high-volume in production.

Sinatra Example

require 'rubygems'
require 'sinatra'

require 'rack/gridfs'
use Rack::GridFS, :hostname => 'localhost', :port => 27017, :database => 'test', :prefix => 'gridfs'

get /.*/ do
  "Whatchya talking about?"


Copyright © 2009 Blake Carlson. See LICENSE for details.

Jump to Line
Something went wrong with that request. Please try again.