Skip to content
This repository

The single-file MongoDB admin app

This branch is 341 commits ahead and 1 commit behind master

Octocat-spinner-32 bin Better --servers help text. December 21, 2013
Octocat-spinner-32 client Move LICENSE and VERSION back. March 20, 2014
Octocat-spinner-32 server Move LICENSE and VERSION back. March 20, 2014
Octocat-spinner-32 spec minor codestyle cleanup. March 11, 2014
Octocat-spinner-32 tasks Move LICENSE and VERSION back. March 20, 2014
Octocat-spinner-32 .bowerrc Changing things around. January 07, 2014
Octocat-spinner-32 .gitattributes Move LICENSE and VERSION back. March 20, 2014
Octocat-spinner-32 .gitignore Add backbone.projections for menus. February 16, 2014
Octocat-spinner-32 .gitmodules Remove the last of the submodules January 05, 2014
Octocat-spinner-32 .htaccess arrrgh. whitespace. December 06, 2012
Octocat-spinner-32 .rspec Fuubar for Rspec, because I’m the boss. December 22, 2013
Octocat-spinner-32 .rubocop.yml RUBOCOP! February 17, 2014
Octocat-spinner-32 .travis.yml allow php 5.6 to fail April 08, 2014
Octocat-spinner-32 CHANGELOG.md Merge branch 'hotfix/2.3.11' into develop March 20, 2014
Octocat-spinner-32 CONTRIBUTING.md Slightly more info about build. January 18, 2014
Octocat-spinner-32 Gemfile Changing things around. January 07, 2014
Octocat-spinner-32 LICENSE Move LICENSE and VERSION back. March 20, 2014
Octocat-spinner-32 README.md Add gem version badge. April 13, 2014
Octocat-spinner-32 Rakefile Add platform specific gems for Windows. February 05, 2014
Octocat-spinner-32 VERSION Move LICENSE and VERSION back. March 20, 2014
Octocat-spinner-32 bower.json Add backbone.projections for menus. February 16, 2014
Octocat-spinner-32 genghis-dev.php Move LICENSE and VERSION back. March 20, 2014
Octocat-spinner-32 genghis-dev.rb Changing things around. January 07, 2014
Octocat-spinner-32 genghis.php Merge branch 'hotfix/2.3.11' into develop March 20, 2014
Octocat-spinner-32 genghis.rb Merge branch 'hotfix/2.3.11' into develop March 20, 2014
Octocat-spinner-32 genghisapp.gemspec Changing things around. January 07, 2014
Octocat-spinner-32 gulpfile.js Clean up watch, livereload in gulp. February 12, 2014
Octocat-spinner-32 package.json fix debowerify to depend on a fork that depends on a fork of falafel March 24, 2014
README.md

Genghis

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

Gem version Build Status Dependency Status

Genghis

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

Standalone

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

$ genghisapp

Now that it's running, you can use genghisapp --kill to stop it.

Windows users: Due to this bug Genghis always runs in foreground mode.

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 pretty 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 config.ru 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 Rack::URLMap.new \
  '/'        => Your::App.new,
  '/genghis' => Genghis::Server.new

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 initializer) and then adding this to routes.rb:

mount Genghis::Server.new, :at => '/genghis'

Genghis Dependencies

PHP

You will need at least PHP 5.2 and the PECL MongoDB driver.

Ruby

Genghis requires Ruby 1.8 or awesomer.

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

Configuration

Check the Genghis wiki for additional configuration information.

License

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

Something went wrong with that request. Please try again.