Fetching contributors…
Cannot retrieve contributors at this time
146 lines (92 sloc) 4.02 KB


The single-file MongoDB admin app, by Justin Hileman.


There are more ways to run Genghis than you can shake a stick at


If you installed Genghis as a Ruby gem, running Genghis standalone is easy:

$ genghisapp

If you didn't go the gem route, you can still run genghis.rb standalone:

$ ruby genghis.rb

genghis.php can also be run as a PHP 5.4 CLI SAPI standalone server:

$ php -S localhost:8000 genghis.php

In your LAMP stack

Simply drop genghis.php in a web-accessible directory on a LAMP server. Don't forget .htaccess for perty URLs!

With nginx and PHP-fpm (and friends)

You'll need some fancy config action, but it's fairly straightforward.

In an existing Rack app

For a super basic Rack config, use a file like this:

require 'genghis'

run Genghis::Server

If you want to load Genghis on a subpath, possibly alongside other apps, it's easy to do with Rack's URLMap:

require 'genghis'

run \
  '/'        =>,
  '/genghis' =>

With Rails 3

You can even mount Genghis on a subpath in your existing Rails 3 app by adding require 'genghis' to the top of your routes file (or in an intializer) and then adding this to routes.rb:

mount, :at => '/genghis'

Genghis Dependencies


You will need the PECL MongoDB driver.


The easiest way to install Genghis and all dependencies is via RubyGems:

$ gem install genghisapp

Or you could check out a local copy of the Git repo and install dependencies via Bundler:

$ gem install bundler
$ bundle install


Check the Genghis wiki for additional configuration information.


Genghis uses a number of amazing open source libraries, distributed under the following licenses