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 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 which proxy to use for each request.
Select On if you want to configure a custom proxy, or PAC if you have a .pac file that defines proxy rules.

​
3. Configuring PAC proxy

If you select PAC mode, you can provide a PAC file in two ways:
  • URL: Enter the URL to a remote PAC file (e.g., https://example.com/proxy.pac). Supported URL schemes are http://, https://, and file://.
  • File: Click Choose file… to browse and select a local .pac file from your filesystem.
PAC files contain JavaScript that determines which proxy server (if any) should be used for a given URL. This is commonly used in corporate environments where different proxy servers handle different network destinations.
The proxy configuration is not saved until a valid PAC URL or file is selected. If you switch to PAC mode without providing a source, the previous proxy settings remain active.

​
4. Selecting proxy protocol

When using On (manual) mode, you can choose from the following proxy protocols:
  • HTTP
  • HTTPS
  • SOCKS4
  • SOCKS5

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

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

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

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