mongo-gui

library0.0.21jsnpmunverified

A web-based GUI for managing MongoDB databases, version 0.0.21. Provides a browser interface to connect to local/remote MongoDB instances, perform CRUD operations on databases and collections, query documents with advanced pagination, import/export CSV/JSON files, and support natural language queries via OpenAI. Release cadence is irregular; no major updates since early 2022. Differentiates from alternatives like Mongo-Express or Studio 3T by offering a lightweight, quickly installable tool with built-in AI querying (requires OpenAI API key). Supports authentication via .env file and Docker deployment.

database

npm install mongo-gui

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · MONGO-GUI

mongo-gui

databasejavascriptv0.0.21

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-gui

✓ No import; run globally via CLI: `npx mongo-gui`

✗ Cannot import as a library

This is a CLI tool, not a library. Install globally or use npx.

Install mongo-gui globally and start it from the command line with optional connection string and port.

# Install globally npm install -g mongo-gui # Run with default MongoDB URL (localhost:27017) on port 4321 mongo-gui # Connect to a remote MongoDB with authentication mongo-gui -u "mongodb+srv://user:pass@cluster.mongodb.net/mydb?retryWrites=true&w=majority" -p 4321 # For Docker, create docker-compose.yml as shown in README, then: docker-compose up

Debug

Known issues

gotchaOpenAI natural language querying requires setting an OpenAI API key in environment variables (OPENAI_API_KEY). Without it, the AI feature will not work.

fix

Set OPENAI_API_KEY environment variable before starting mongo-gui.

affects: >=0.0.1

gotchaRunning mongo-gui on a remote server without authentication exposes your MongoDB data to anyone who accesses the web interface.

fix

Enable authentication by creating a .env file with USERNAME and PASSWORD values.

affects: >=0.0.1

gotchaThe default port 4321 may conflict with other services; ensure port is free or specify a different port via -p flag.

fix

Use -p flag to set a custom port, e.g., mongo-gui -p 8080.

affects: >=0.0.1

Errors

Common errors & fixes

mongo-gui : The term 'mongo-gui' is not recognized as the name of a cmdlet, function, script file, or operable program.

Package not installed globally or not in PATH.

fix

Install globally with `npm install -g mongo-gui` or use npx: `npx mongo-gui`.

Error: connect ECONNREFUSED 127.0.0.1:27017

MongoDB is not running on localhost:27017.

fix

Start MongoDB service or provide a different MongoDB URL via -u flag.

MongoNetworkError: failed to connect to server [host:port] on first connect

Incorrect MongoDB connection string or network issues.

fix

Verify the connection string format and ensure MongoDB is accessible from your network.

Upgrade

Version history

0.0.21latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/arunbandari/mongo-gui ↗

packagemongo-gui ↗

homepagehttp://20.106.238.56:4321/ ↗