Need help with adminMongo?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

3.8K Stars 830 Forks MIT License 301 Commits 114 Opened issues


adminMongo is a Web based user interface (GUI) to handle all your MongoDB connections/databases needs.

Services available


Need anything else?

Contributors list


npm downloads badge npm version badge Build Status Github stars

adminMongo is a cross platform user interface (GUI) to handle all your MongoDB connections/databases needs. adminMongo is fully responsive and should work on a range of devices.

adminMongo connection information (including username/password) is stored unencrypted in a config file, it is not recommended to run this application on a production or public facing server without proper security considerations.


If my work helps you, please consider buying me a coffee


  1. Navigate to folder & install adminMongo:
    git clone && cd adminMongo
  2. Install dependencies:
    npm install
  3. Start application:
    npm start
    node app
  4. Visit in your browser

Note: Node.js version 4.x or above is required

Electron App

adminMongo can also be used as a cross platform Electron application. Due to the size of Electron it will need to be built manually.

To build for Mac:

$ npm run-script packageOsx

To build for Windows:

$ npm run-script packageWin32

To build for Linux:

$ npm run-script packageLinux

Once built, the executable will be in the


Prebuilt binaries

Prebuilt binaries can be downloaded here:

Mac 64bit

Windows 32bit

Windows 64bit

The Electron builds have been tested on Mac and Windows 10. Linux has not been tested. Please report any issues.

Deploy on Heroku


Demo (read only)

A read only demo can be seen here


  • Manage from a connection level for easy access to multiple databases
  • Create/Delete databases
  • Backup/Restore databases
  • Create/Delete/Edit collection
  • Create/Delete/Edit documents
  • Create/Delete indexes
  • Query documents
  • Collection statistics
  • Export collections in JSON format
  • Server monitoring

Current limitations

  • Documents need to have an "_id" value which is a string, integer, or MongoDB ObjectId. Documents using Composite ID indexing is currently not supported.
  • Connection strings with multiple hosts for replica sets are currently not supported.


adminMongo will listen on host:

and port:
by default. This can be overwritten by adding a config file in
. For example:
    "app": {
        "host": "",
        "port": 4321,
        "password": "secureadminpassword",
        "locale": "de",
        "context": "dbApp",
        "monitoring": false

Note: Any changes to the config file requires a restart of the application

All above parameters are usable through the environment which makes it very handy to when using adminMongo as a docker container! just run

docker run -e HOST=yourchoice -e PORT=1234 ...

The config file (optional) options are:

|Option|Env-variable|Definition| |--- |--- |--- | |

|The IP address
will listen on| |
|The Port
will listen on| |
|An application level password to add simply authentication| |
|The locale is automatically set to the detected locale of Nodejs. If there is not a translation,
will default to English. This setting overrides the default/detected value| |
|Setting a
of "dbApp" is like changing the base URL of the app and will mean the app will listen on
. Ommiting a context will mean the application will listen on root. Eg:
. This setting can be useful when running
behind Nginx etc.| |
|Whether to run monitoring at regular intervals. Defaults to true or on|

Setting a context path

Setting a

of "dbApp" is like changing the base URL of the app and will mean the app will listen on
. Ommiting a context will mean the application will listen on root. Eg:
. This setting can be useful when running
behind Nginx etc.

An example Nginx server block. Note the

location /dbApp {
lines match the
set in the
server {
    listen 80;


location /dbApp {
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection 'upgrade';
    proxy_set_header Host $host;
    proxy_cache_bypass $http_upgrade;


Language locale

Looking for people to translate into other languages. If you can help, grab the

file, translate to your language and submit a pull request.

The locale is automatically set to the detected locale of Nodejs. If there is not a translation,

will default to English. To override the detected locale a setting can be added to the
file. See Configuration section for a "German" example.


By default

is not password protected. You can add password authentication by adding a
value to the
file (See the Configuration section). Once added you will need to restart
and all routes will be protected until the correct password is added. You will then be authenticated for the life of the session (60 mins by default) or if the "Logout" link is clicked.


Create a connection

After visiting you will be presented with a connection screen. You need to give your connection a unique name as a reference when using adminMongo and a MongoDB formatted connection string. The format of a MongoDB connection string can form:

where specifying to the
 level is optional. For more information on MongoDB connection strings, see the official MongoDB documentation.

You can supply a connection options object (see docs) with each connection.

For example:

    "poolSize": 10,
    "autoReconnect": false,
    "ssl": false

Note: The connection can be either local or remote hosted on VPS or MongoDB service such as mLab.

The connection can also be automatically initiated through the environment (or with the docker -e parameters)

|Env-variable|Description| |--- |--- | |

|The name of the connection to create on boot| |
|The username for the database connection| |
|The password for the database user| |
|The host IP address or DNS name without the port!| |
|The port of the mongoDB database, if not provided the default 27017 will be used| |
|The name of the database|

The Connection setup screen adminMongo connections screen

Connection/Database admin

After opening your newly created connection, you are able to see all database objects associated with your connection. Here you can create/delete collections, create/delete users and see various stats for your database.

The connections/database screen adminMongo database screen


After selecting your collection from the "Database Objects" menu, you will be presented with the collections screen. Here you can see documents in pagination form, create new documents, search documents, delete, edit documents and view/add indexes to your collection.

The collections screen adminMongo collections screen

Searching/Querying documents

You can perform searches of documents using the

Search documents
button on the collections screen. You will need to enter the key (field name) and value. Eg: key = "id" and value = "569ff81e0077663d78a114ce" (Only works on string "id" fields - Use "Query Documents" for ObjectID's).

You can clear your search by clicking the

button on the collections screen.

Simple search documents adminMongo search documents

Complex querying of documents is done through the "Query documents" button. This allows a query Object to be passed to MongoDB to return results. Queries can be written in full BSON format or EJSON format. For example these queries should return the same results:


is equivalent to:

    "$oid": "56a97ed3f718fe9a4f599489"

Query documents adminMongo search documents


Adding and editing documents is done using a JSON syntax highlighting control.

Editing a document adminMongo documents

Documents with Media embedded show previews

Documents with media adminMongo media

Server Monitoring

Functionality currently in Beta

Selected server monitoring is done at regular intervals and stored in local database store for 24hrs.

New connections require an app restart for monitoring to commence

Server monitoring adminMongo server monitoring


Indexes can be added from the collection screen. Please see the official MongoDB documentation on adding indexes.

Viewing/Adding indexes adminMongo documents



API tests include:
  • Add and remove a connection
  • Add and remove a database
  • Add, remove and rename a collection
  • Create and delete a user
  • Add, query and delete a document

To run tests, simply run:

npm test

Note: You will need to ensure there is no password protection setup in the


You may need to edit the variables and connection string in

for your MongoDB instance.

If you see any missing tests, please submit a PR.


  1. Fork it!
  2. Create your feature branch:
    git checkout -b my-new-feature
  3. Commit your changes:
    git commit -am 'Add some feature'
  4. Push to the branch:
    git push origin my-new-feature
  5. Submit a pull request :D

Future plans

Please make any suggestions.


The MIT License

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.