Skip to main content

Documentation Index

Fetch the complete documentation index at: https://bruno-a6972042-mintlify-testing-jsonbody-jsonschema-1777266.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

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 four options for proxy mode:
  • Off: Disables proxy usage.
  • On: Enables proxy and routes requests through a manually configured proxy.
  • System Proxy: Uses the system-wide proxy settings.
  • PAC: Uses a Proxy Auto-Configuration (PAC) file to determine the proxy for each request.
Select On if you want to configure a custom proxy, or PAC if your network uses a PAC file for automatic proxy configuration.

​
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 PAC proxy

When you select the PAC proxy mode, Bruno resolves the appropriate proxy for each request using a PAC file. You can provide the PAC file in two ways:
  • URL: Enter the URL to your PAC file (e.g., https://example.com/proxy.pac). The URL must use the http://, https://, or file:// protocol.
  • File: Click Choose file… to select a .pac file from your local filesystem.
Bruno evaluates the FindProxyForURL function in the PAC file for each request and routes traffic through the returned proxy. pac-proxy

​
7. 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.