Support

MongoBro supports all standard MongoDB connection string formats:

• mongodb://localhost:27017 — local server, no auth
• mongodb://username:password@host:27017 — with authentication
• mongodb://user:pass@host:27017/mydb — with a specific database
• mongodb+srv://user:pass@cluster0.mongodb.net — MongoDB Atlas (SRV)

When connecting from a physical device, localhost refers to the device itself, not your computer. You need to use your computer's local network IP address instead.

Find your computer's IP address:

• Mac/Linux: Run ifconfig or check System Preferences → Network
• Windows: Run ipconfig in Command Prompt

Then use: mongodb://192.168.x.x:27017

Android Emulator only: Use 10.0.2.2 as the host to reach your development machine's localhost.

Also ensure MongoDB is bound to 0.0.0.0 (not just 127.0.0.1) in its config, and that your firewall allows port 27017.

1. In MongoDB Atlas, go to your cluster and click Connect.

2. Choose Connect your application and copy the connection string.

3. Replace <password> with your database user's password.

4. Paste the full URI into MongoBro and tap Connect.

Example: mongodb+srv://myuser:mypassword@cluster0.abc12.mongodb.net

Make sure your device's IP is added to the Atlas Network Access allow list (or set it to allow from anywhere: 0.0.0.0/0 for testing).

On the Connection screen, enter your URI in the field and tap the Save button. You'll be asked to give the connection a name (e.g., "Production", "Atlas Dev").

Saved connections appear below the input field. Tap any saved connection to load its URI and connect instantly.

To remove a saved connection, tap the trash icon next to it.

MongoBro 1.0 is a read-only browser. You can view databases, collections, and documents, but cannot create, edit, or delete data. Write operations are planned for a future version.

Your connection URIs are stored locally on your device using the operating system's standard storage (Android SharedPreferences / iOS NSUserDefaults). They are never sent to MongoBro's servers — we don't have any.

For best security:

• Use a MongoDB user with read-only permissions when browsing
• Enable a screen lock on your device
• Avoid storing URIs with admin credentials in the saved connections list

Common causes:

• Wrong host/port: Double-check the hostname and that MongoDB is running on the expected port (default: 27017).
• Network: Ensure your phone and MongoDB server are on the same network (or the server is publicly accessible).
• Firewall: Port 27017 must be open on the server's firewall.
• MongoDB bindIp: Ensure MongoDB's bindIp is set to 0.0.0.0 or your device's IP (not just 127.0.0.1).
• Wrong credentials: Check that the username and password in the URI are correct.
• Atlas IP Allow List: Add your mobile network's IP or use 0.0.0.0/0 in Atlas Network Access settings.

MongoBro uses the mongo_dart driver which supports standard MongoDB connection URIs. Replica set and Atlas SRV connections should work via the standard URI format. Full replica set configuration options are not exposed in the UI in v1.0.

To remove individual saved connections, use the delete (trash) icon next to each one on the Connection screen.

To remove all app data at once, uninstall MongoBro from your device. This permanently removes all locally stored connection strings.