Skip to main content
A proxy is an intermediary server that sits between a client application (like Bruno) and the destination server that the client is communicating with (like an API). The proxy server acts as a security barrier, making requests on your behalf to websites and other internet resources, and preventing others from accessing your internal network. If your machine sits behind a corporate network or firewall, you may need to configure the proxy settings in Bruno in order for requests to be made.
Starting from v3.1.0+, System Proxy is enabled by default for new users and Existing users retain their current preference settings.
Below are steps for configuring your proxy settings at different levels within Bruno.

​
1. Accessing Proxy Settings

  1. Open Bruno.
  2. Click on the Preferences section from the bottom left corner.
  3. Navigate to the Proxy tab in the sidebar.
proxy-settings

​
2. Configuring Proxy Mode

Bruno provides three options for proxy mode:
  • Off: Disables proxy usage.
  • On: Enables proxy and routes requests through the configured proxy.
  • System Proxy: Uses the system-wide proxy settings.
Select On if you want to configure a custom proxy.

​
3. Selecting Proxy Protocol

Bruno supports different proxy protocols. Choose one of the following:
  • HTTP
  • HTTPS
  • SOCKS4
  • SOCKS5

​
4. Entering Proxy Details

Fill in the required fields:
  • Hostname: The proxy server’s domain or IP address (e.g., example.com).
  • Port: The port number for the proxy connection (e.g., 3000).

​
5. Enabling Authentication (Optional)

If your proxy requires authentication:
  1. Check the Auth checkbox.
  2. Enter the Username.
  3. Enter the Password (Click the eye icon to reveal the password if needed).

​
6. Configuring Proxy at Collection Level

There may be instances in which your collection needs to use a different proxy than what you have configured globally. Configuring proxy settings at the collection level will override any configuration you’ve made in the preferences section. Below are instructions on proxy settings at the collection level:
  1. Open the collection settings.
  2. Navigate to the Proxy tab.
collection-proxy

​
Choose the Configuration Mode:

  • inherit: Uses the main proxy settings from Preferences.
  • Enabled: Enables a custom proxy for this collection.
  • Disabled: Disables the proxy for this collection.
  1. Choose inherit, enabled, or disabled.
  2. Enter the Hostname, Port, Protocol, Username, and Password if needed.
  3. Click Save to apply the settings.

​
7. Proxy support for gRPC requests

Bruno’s proxy settings apply to both HTTP and gRPC requests. However, gRPC proxy support has the following limitations:
  • Only HTTP proxies are supported — gRPC connections use HTTP CONNECT tunneling. SOCKS4, SOCKS5, and HTTPS proxy protocols are not supported for gRPC. If you configure one of these protocols, gRPC requests will bypass the proxy and connect directly.
  • Authentication is supported — proxy username and password work the same as for HTTP requests.
  • Bypass rules apply — the bypass proxy list is respected for gRPC requests.
  • System proxy mode — when set to “System Proxy”, gRPC uses the standard http_proxy/https_proxy environment variables. Only HTTP-protocol system proxies are used; non-HTTP system proxies are ignored.
If your proxy is configured with a SOCKS or HTTPS protocol, gRPC requests will connect directly without going through the proxy. HTTP/REST requests are unaffected and will continue to use the configured proxy protocol.

​
8. Saving proxy configuration

After entering the proxy details, click the Save button to apply the changes. Your proxy settings are now configured in Bruno.