Skip to content

A very light "ready to use" Genghis app based on Alpine

Notifications You must be signed in to change notification settings

dockervan/genghis

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Genghis Docker image

A very light "ready to use" Genghis app based on Alpine.

Supported tags and respective Dockerfile links

What is Genghis?

Genghis is a single-file MongoDB admin app, by Justin Hileman.

How to use this image

Start a Genghis instance

docker run --name genghis-app --link mongo-instance:db dockervan/genghis

You have to set at least one mongo link named db to get Genghis working properly.

This image includes EXPOSE 5678 (the Genghis default port), so standard container linking will make it automatically available to the linked containers.

You can also publish the container port:

docker run --name genghis-app --link mongo-instance:db -p 5678:5678 dockervan/genghis

Genghis will be available on http://localhost:5678.

Link multiple databases

You can link multiple databases to your Genghis app. All links names must be prefixed by db_:

docker run --name genghis-app --link mongo-instance:db --link other-instance:db_2 --link mongofoo:db_foo -p 5678:5678 dockervan/genghis

Use a custom servers dsn list

If you have a complex mongo structure that can not be compatible with the previous example, you can add a servers.custom file that will contain arguments to give at the --servers option of Genghis.

Example of servers.custom:

db;localhost;42.42.42.42:25847

Once the file created, link it on docker command:

docker run --name genghis-app --link mongo-instance:db --volume /path/to/servers.custom:/servers.custom:ro dockervan/genghis

Docker compose

Here a light example to use this image with docker-compose:

mongo:
  image: mongo:2.6

genghis:
  image: dockervan/genghis
  links:
    - mongo:db
  ports:
    - '8101:5678'

Why using this image?

In contrary to the other Genghis images, this one is based on Alpine Linux OS and provide a very light application (less than 30 MB).

This method is perfect for "ready to use" application images. You can see another example with phpMyAdmin official image.

About

A very light "ready to use" Genghis app based on Alpine

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages