50K+
saniewski/mongo-express-docker-extension:2.0.2
Run Mongo Express in Docker Desktop and connect to any MongoDB server.
This requires Docker Desktop 4.10 or higher.
Browse and manage MongoDB databases with Mongo Express inside Docker Desktop. Connect to a local or remote MongoDB server without installing Mongo Express yourself or configuring its container manually.
Start Docker Desktop and have a running MongoDB server reachable from it. The extension starts Mongo Express; you provide the MongoDB server and any credentials it requires.
Local development. 27017), and optional username/password. Choose Connection string to paste a mongodb:// or mongodb+srv:// URI instead. Saving a connection only stores its settings. Test connection connects and pings MongoDB using a temporary container that is removed afterward. Open starts Mongo Express using the saved settings. The first test or session may take longer while Docker downloads the Mongo Express image.
host.docker.internal and the MongoDB port. For a single-host connection, localhost and 127.0.0.1 are also translated to host.docker.internal. my-mongo, and its internal MongoDB port (usually 27017). The extension automatically joins a matching container network for the mongo, bitnami/mongodb, and circleci/mongo images. A Compose service name alone may not match the container name. host.docker.internal and the published host port. For a mapping of 27018:27017, enter 27018. This also works for custom images or network setups where automatic container network selection does not work. mongodb+srv:// connection string, a database user, and an allowed client IP address in Atlas network access settings. Example connection strings (replace the example credentials and cluster hostname with your own):
mongodb://host.docker.internal:27017mongodb://app-user:[email protected]:27017/app?authSource=adminmongodb+srv://app-user:[email protected]/app?authSource=admin In a URI, percent-encode special characters in usernames and passwords, such as @ as %40. With Host and credentials, enter credentials normally; the extension handles encoding. See the MongoDB connection string documentation for options such as authSource and replica set settings.
Returning with Connections stops and removes the session container while keeping your saved connection. Containers left behind by an interrupted session are cleaned up when the connections page next opens. Closing or deleting a saved connection does not remove your MongoDB server or its data.
Saved connection details, including passwords and credentials in URIs, remain in the Docker Desktop extension browser localStorage and are not encrypted by the extension. Remove saved connections you no longer need, and avoid saving secrets on a shared desktop account.
Enable Database-scoped mode when you want Mongo Express to show one database, including when your account cannot list all databases.
app. mongodb://host.docker.internal:27017/app. This disables Mongo Express admin features and limits browsing to that database. MongoDB still enforces the account read/write permissions. The mode is off by default; adding a database to a URI alone does not enable it.
Host and credentials authenticates against admin. If the user was created in another database, use Connection string with the appropriate authSource. For a user created in app, use mongodb://app-user:[email protected]:27017/app?authSource=app.
Enable TLS settings to turn on TLS and optionally configure a custom certificate authority or a client certificate.
Use Browse or enter an absolute path on the Docker Desktop host. Docker Desktop must be able to access the files through its file sharing settings. The extension stores only their paths and mounts the selected files read-only into Mongo Express. Use Test connection to check the TLS settings before saving. Save the connection, then open it to apply the settings. Close and reopen the connection after renewing or replacing certificates.
Enabled TLS settings override the certificate paths and verification options in the URI. When disabled, no certificate files are mounted and TLS follows the URI, including the default TLS behavior of mongodb+srv://.
If Test connection fails, the modal shows the reason. Correct the settings and test again; changing a field clears the previous result.
If Service Unavailable appears, read the error message. Select Back to connections to edit the saved settings, or Try again to retry with the same settings after fixing the problem.
authSource. For an account limited to one database, enable Database-scoped mode and supply its database name. If the problem persists, select Report an issue on the error page and include the error message with any credentials removed.