mongo-express

library1.1.0-rc-4jsnpmunverified

mongo-express is a web-based MongoDB admin interface built with Node.js, Express, and Bootstrap 5. The current stable version is 1.1.0-rc-4, released as a release candidate. It supports multiple databases, document CRUD, GridFS, BSON data types, and OpenID Connect authentication. Key differentiators include inline preview of audio/video/image assets, collapsible nested objects, and async on-demand loading of large document properties. Requires Node.js >=18.18. Compatible with FerretDB and Amazon DocumentDB.

database

npm install mongo-express

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · MONGO-EXPRESS

mongo-express

databasejavascriptv1.1.0-rc-4

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

mongo-express (CLI)

✓ mongo-express (run via npx or global install)

✗ const mongoExpress = require('mongo-express')

mongo-express is a CLI application, not a library. Use npx or install globally.

config.default.js

✓ Copy and edit config.default.js to config.js in the node_modules/mongo-express folder

✗ Modify config.default.js directly

Always create a config.js file; config.default.js is overwritten on update.

Express app integration

✓ Use the built-in server; do not programmatically import

✗ import mongoExpress from 'mongo-express'

mongo-express does not export a programmatic API. Run as a standalone server.

Installs mongo-express globally and starts the web interface on the default port 8081 connecting to local MongoDB.

npm install -g mongo-express mongo-express -u admin -p pass -d admin --url mongodb://localhost:27017

Debug

Known issues

gotchaDefault credentials are admin:pass - not safe for production

fix

Change credentials in config.js or use environment variables MONGO_EXPRESS_USER and MONGO_EXPRESS_PASSWORD.

affects: >=0.1

breakingNode.js version requirement changed from >=14 to >=18.18 in v1.0.0

fix

Upgrade Node.js to v18.18 or later.

affects: >=1.0.0

deprecatedSupport for MongoDB <3.6 is deprecated in v1.0.0

fix

Upgrade MongoDB to 3.6 or later, or use an older version of mongo-express.

affects: >=1.0.0

gotchaOpening mongo-express to the internet without authentication is dangerous

fix

Enable authentication via config.js or use a reverse proxy with auth.

affects: >=0.1

breakingRemoved support for mongodb-version-specific connection strings in v1.0.0

fix

Use standard MongoDB connection strings without version tags.

affects: >=1.0.0

Errors

Common errors & fixes

Error: Cannot find module 'mongo-express'

Global install not found or not in PATH

fix

Install globally with npm install -g mongo-express and ensure node bin directory is in PATH.

MongoNetworkError: connect ECONNREFUSED 127.0.0.1:27017

MongoDB not running or connection string incorrect

fix

Start MongoDB (mongod) or specify correct host/port via --url or config.js.

ReferenceError: config is not defined

Config file not properly copied or named

fix

Copy config.default.js to config.js in the mongo-express installation directory.

mongo-express requires Node.js >=18.18

Running on older Node.js version

fix

Upgrade Node.js to 18.18 or higher.

Upgrade

Version history

1.1.0-rc-4latest on npm

Audit

Dependencies

express-openid-connectoptionalOptional peer dependency for OpenID Connect authentication support

Agent activity

2 hits · last 30 days

node

Resources

githubgit://github.com/mongo-express/mongo-express ↗

packagemongo-express ↗

homepagehttps://github.com/mongo-express/mongo-express#readme ↗