Connect through a proxy

Some networks only let traffic out through a proxy. The Proxy tab of the connection dialog sends one connection through an HTTP or SOCKS proxy; Preferences holds a default proxy that any connection can use.

Use a proxy for one connection

1. Open the connection dialog and click the Proxy tab.
2. Under Connect using:, choose Custom proxy (HTTP and SOCKS).
3. Choose the Protocol: (HTTP or SOCKS).
4. Enter Host name or address: and Port: of the proxy.
5. Click Test Connection, then Save.

Use the application’s default proxy

1. Open Edit > Preferences (Ctrl+P) and go to Advanced settings > Network.
2. Under Proxy for network access, tick Use proxy server configuration and enter Protocol:, Host name or address: and Port:.
3. Apply the preferences.
4. In each connection that should use it, choose Application default proxy (see Network in Preferences > Advanced settings) on the Proxy tab.

Changing the default proxy later changes it for every connection that uses it.

Reference

The Network page also has a separate Proxy for Oxys DB Studio tools section. It covers the application’s own web traffic (the update check, the AI Helper and Team Sharing), not database connections: Network access proxy config., System proxy config. or Direct connection, with optional basic-auth credentials, and a Test connectivity button.

Tips

• With an SSH tunnel, the tunnel is the way to the servers; you normally need one or the other, not both.
• An HTTP proxy must allow the CONNECT method to the MongoDB port.

Troubleshooting