Connections

Use a connection string

Open Application menu → Manage connections → Add. New profiles start in Connection string mode. Give the profile a name and enter a URI supplied by your MongoDB administrator or hosting provider.

mongodb://localhost:27017/shop
mongodb+srv://example.mongodb.net/shop

These illustrate the two supported schemes; the second hostname is a placeholder. Authentication credentials, TLS settings and network access must match your deployment. Test details checks the draft without saving it. Add connection saves it.

Use individual fields

Choose the Manual tab to enter the host, port, default database, username, password and authentication database separately. The form also includes TLS, authentication mechanism, replica-set name, routing/read preference and additional URI options.

• A standard connection uses mongodb://. A blank port defaults to 27017.
• A DNS SRV connection uses mongodb+srv://, one hostname and no port. DNS supplies the server list; TLS is enabled by default.
• Authentication database is where the user authenticates. It can differ from the database you want to browse.
• Enter decoded usernames and passwords in the manual form; Palryn encodes them into the URI.
• Use additional name/value options for settings such as certificate paths and timeouts.

Switch back to Connection string for direct URI editing. URI forms that cannot be represented by the manual editor remain editable as source.

Test, edit and reconnect

Saved connection cards provide Test, Connect, Reconnect and Disconnect. Testing a profile checks connectivity; it does not execute one of your query drafts.

Edit retrieves the saved details, initially masking the password and URI. Use the eye controls to reveal them when needed. Saving edits disconnects the existing session. Reconnect and rerun queries to obtain results from the updated target.

A connection can be opened directly from the workspace selector or added to a named workspace. The same saved profile can be used in more than one workspace.

Clipboard shortcuts

If the connection manager detects a new MongoDB URI on your clipboard while no editor is open, it offers Add clipboard connection. Accepting opens a prefilled draft; review it and explicitly save it. Dismissing the offer does not change a saved profile.

Copy connection string copies the complete saved URI, including any embedded credentials. It is intended for places where you need the full connection details.

Where connection details live

Saved connection URIs use the operating system keychain: Windows Credential Manager on Windows, or an available, unlocked Secret Service on Linux. Workspace drafts contain profile references, not the saved credentials.

If a profile cannot be saved or retrieved, check that the keychain service is available and unlocked. For connection failures, see connection troubleshooting.