> ## Documentation Index
> Fetch the complete documentation index at: https://docs.safesquid.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Forward Proxy

> Configure web browsers to use SafeSquid proxy server, including detailed steps for Chrome and Firefox proxy settings to access the SafeSquid WebGUI.

# Forward proxy requires explicit client configuration

## Why explicit proxy is used

Uncontrolled direct internet access increases malware, data loss, and compliance risk. SafeSquid provides a browser-based WebGUI at `http://safesquid.cfg` (an embedded Rest UI interface built into SafeSquid; accessible via proxy, NOT resolved by DNS) for configuration and management. Clients must send traffic through SafeSquid by configuring the browser or system proxy. Forward (explicit) proxy gives administrators clear control over which applications use the proxy and supports per-browser or per-application rollout.

## Benefits of forward proxy mode

Explicit configuration ensures only intended traffic is inspected. Policy enforcement and logging apply to configured clients. No network-layer redirection is required; deployment fits environments where endpoint configuration is manageable. **Limitation:** Applications that do not use the configured proxy bypass SafeSquid unless system-wide or PAC-based proxy is used.

## Prerequisites

**Client-side:** Browser supporting manual proxy configuration (Chrome, Firefox, or equivalent). SafeSquid proxy IP and port (default 8080). **SafeSquid-side:** SafeSquid deployed and listening on the proxy port; WebGUI reachable via proxy at `http://safesquid.cfg` (embedded interface, NOT DNS-resolved).

## Configure proxy in Chrome (system settings)

1. Open Chrome browser settings from the toolbar.

   <img src="https://mintcdn.com/safe-squid-labs-12a0916f/mWo6q6ffjJZSjew5/images/How_To/How_To_configure_Proxy_In_a_Browser/image1.webp?fit=max&auto=format&n=mWo6q6ffjJZSjew5&q=85&s=710763b2b70e53df43f2a401972a0314" alt="Chrome menu" width="1379" height="776" data-path="images/How_To/How_To_configure_Proxy_In_a_Browser/image1.webp" />

   <img src="https://mintcdn.com/safe-squid-labs-12a0916f/mWo6q6ffjJZSjew5/images/How_To/How_To_configure_Proxy_In_a_Browser/image2.webp?fit=max&auto=format&n=mWo6q6ffjJZSjew5&q=85&s=86cd64c1f6c41d7f78accfbdcbf25c42" alt="Settings option" width="1379" height="776" data-path="images/How_To/How_To_configure_Proxy_In_a_Browser/image2.webp" />

2. Click the **System** tab in Settings, or search for "proxy" in the search bar.

   <img src="https://mintcdn.com/safe-squid-labs-12a0916f/mWo6q6ffjJZSjew5/images/How_To/How_To_configure_Proxy_In_a_Browser/image3.webp?fit=max&auto=format&n=mWo6q6ffjJZSjew5&q=85&s=c82ed29eaa25fef963324dd822c60581" alt="System tab" width="1379" height="775" data-path="images/How_To/How_To_configure_Proxy_In_a_Browser/image3.webp" />

   <img src="https://mintcdn.com/safe-squid-labs-12a0916f/mWo6q6ffjJZSjew5/images/How_To/How_To_configure_Proxy_In_a_Browser/image4.webp?fit=max&auto=format&n=mWo6q6ffjJZSjew5&q=85&s=4b7303a301a3ce541460c56bc3ee9457" alt="Search proxy" width="1379" height="776" data-path="images/How_To/How_To_configure_Proxy_In_a_Browser/image4.webp" />

3. Click **Open your computer's proxy settings**.

   <img src="https://mintcdn.com/safe-squid-labs-12a0916f/mWo6q6ffjJZSjew5/images/How_To/How_To_configure_Proxy_In_a_Browser/image5.webp?fit=max&auto=format&n=mWo6q6ffjJZSjew5&q=85&s=c5980e7ad86da41d157769f761bd815b" alt="Proxy settings link" width="1379" height="776" data-path="images/How_To/How_To_configure_Proxy_In_a_Browser/image5.webp" />

4. Enable **Use a proxy server**.

   <img src="https://mintcdn.com/safe-squid-labs-12a0916f/mWo6q6ffjJZSjew5/images/How_To/How_To_configure_Proxy_In_a_Browser/image6.webp?fit=max&auto=format&n=mWo6q6ffjJZSjew5&q=85&s=dd27f8efdc3ac49fd83aecb107eeaad4" alt="Enable proxy" width="1379" height="775" data-path="images/How_To/How_To_configure_Proxy_In_a_Browser/image6.webp" />

   <img src="https://mintcdn.com/safe-squid-labs-12a0916f/mWo6q6ffjJZSjew5/images/How_To/How_To_configure_Proxy_In_a_Browser/image7.webp?fit=max&auto=format&n=mWo6q6ffjJZSjew5&q=85&s=7e207fa4bc62d897e24266036f5c4cba" alt="Proxy toggle" width="1379" height="776" data-path="images/How_To/How_To_configure_Proxy_In_a_Browser/image7.webp" />

5. Enter the proxy server IP address and port **8080**.

   <img src="https://mintcdn.com/safe-squid-labs-12a0916f/mWo6q6ffjJZSjew5/images/How_To/How_To_configure_Proxy_In_a_Browser/image8.webp?fit=max&auto=format&n=mWo6q6ffjJZSjew5&q=85&s=a708247980f2c1aaf5875844649c72b0" alt="Proxy address and port" width="1379" height="776" data-path="images/How_To/How_To_configure_Proxy_In_a_Browser/image8.webp" />

6. (Optional) Enter domains and IP addresses to bypass the proxy in the exclusion field:

   * Example: `infatica.io`, `192.158.1.38`, addresses starting with `127.`

   <img src="https://mintcdn.com/safe-squid-labs-12a0916f/mWo6q6ffjJZSjew5/images/How_To/How_To_configure_Proxy_In_a_Browser/image9.webp?fit=max&auto=format&n=mWo6q6ffjJZSjew5&q=85&s=dffe7aaeab10de29b05d9264ae51a9a2" alt="Proxy bypass list" width="1379" height="776" data-path="images/How_To/How_To_configure_Proxy_In_a_Browser/image9.webp" />

7. Click **Save**.

   <img src="https://mintcdn.com/safe-squid-labs-12a0916f/mWo6q6ffjJZSjew5/images/How_To/How_To_configure_Proxy_In_a_Browser/image10.webp?fit=max&auto=format&n=mWo6q6ffjJZSjew5&q=85&s=c5cf0c5a11fbf51f380a25d101e1ddbf" alt="Save settings" width="1379" height="776" data-path="images/How_To/How_To_configure_Proxy_In_a_Browser/image10.webp" />

## Configure Proxy in Firefox

Firefox allows browser-specific proxy configuration without affecting system-wide settings.

1. Open Firefox and click the **menu button** (three horizontal lines) in the top right corner.

   <img src="https://mintcdn.com/safe-squid-labs-12a0916f/mWo6q6ffjJZSjew5/images/How_To/How_To_configure_Proxy_In_a_Browser/image11.webp?fit=max&auto=format&n=mWo6q6ffjJZSjew5&q=85&s=10741ab6e98a111d3399f277c89c235c" alt="Firefox menu" width="1379" height="775" data-path="images/How_To/How_To_configure_Proxy_In_a_Browser/image11.webp" />

2. Click **Settings**.

   <img src="https://mintcdn.com/safe-squid-labs-12a0916f/mWo6q6ffjJZSjew5/images/How_To/How_To_configure_Proxy_In_a_Browser/image12.webp?fit=max&auto=format&n=mWo6q6ffjJZSjew5&q=85&s=9da77158c4413929c3f44328aaa4c81c" alt="Firefox settings" width="1379" height="776" data-path="images/How_To/How_To_configure_Proxy_In_a_Browser/image12.webp" />

3. Scroll down to **Network Settings** in the General section.

   <img src="https://mintcdn.com/safe-squid-labs-12a0916f/mWo6q6ffjJZSjew5/images/How_To/How_To_configure_Proxy_In_a_Browser/image13.webp?fit=max&auto=format&n=mWo6q6ffjJZSjew5&q=85&s=0ea86b2892b5953af73068e387ac35da" alt="Network Settings" width="1379" height="776" data-path="images/How_To/How_To_configure_Proxy_In_a_Browser/image13.webp" />

4. Click the **Settings** button.

   <img src="https://mintcdn.com/safe-squid-labs-12a0916f/mWo6q6ffjJZSjew5/images/How_To/How_To_configure_Proxy_In_a_Browser/image14.webp?fit=max&auto=format&n=mWo6q6ffjJZSjew5&q=85&s=99441d6ccbf07c3a8af4bd21a65c48a9" alt="Settings button" width="1379" height="776" data-path="images/How_To/How_To_configure_Proxy_In_a_Browser/image14.webp" />

5. Select **Manual proxy configuration**.

   <img src="https://mintcdn.com/safe-squid-labs-12a0916f/mWo6q6ffjJZSjew5/images/How_To/How_To_configure_Proxy_In_a_Browser/image15.webp?fit=max&auto=format&n=mWo6q6ffjJZSjew5&q=85&s=ff9540691742815c2e2500073abc088f" alt="Manual proxy option" width="1379" height="776" data-path="images/How_To/How_To_configure_Proxy_In_a_Browser/image15.webp" />

6. Enter the proxy server address and port number.

   <img src="https://mintcdn.com/safe-squid-labs-12a0916f/mWo6q6ffjJZSjew5/images/How_To/How_To_configure_Proxy_In_a_Browser/image16.webp?fit=max&auto=format&n=mWo6q6ffjJZSjew5&q=85&s=e5e2e9567646cc8d988afbb59c131053" alt="Proxy details" width="1379" height="776" data-path="images/How_To/How_To_configure_Proxy_In_a_Browser/image16.webp" />

7. Click **OK** to save changes.

   <img src="https://mintcdn.com/safe-squid-labs-12a0916f/mWo6q6ffjJZSjew5/images/How_To/How_To_configure_Proxy_In_a_Browser/image17.webp?fit=max&auto=format&n=mWo6q6ffjJZSjew5&q=85&s=c8d8a54284e5961759d18e93201dee3e" alt="Save Firefox settings" width="1379" height="776" data-path="images/How_To/How_To_configure_Proxy_In_a_Browser/image17.webp" />

## Verify configuration

Open `http://safesquid.cfg` through the proxy; the SafeSquid WebGUI loads. Browse an external site; traffic appears in SafeSquid access logs from the client IP. **Interface:** Confirm proxy IP and port in browser or system proxy settings. **Logs:** Check `access.log` or Reporting for requests from the client.

## Troubleshooting

| Symptom                        | Likely cause                        | Resolution                                                             |
| ------------------------------ | ----------------------------------- | ---------------------------------------------------------------------- |
| WebGUI or sites do not load    | Wrong proxy IP/port or proxy down   | Verify SafeSquid is listening on 8080; confirm IP and port in browser. |
| Some sites work, others fail   | Bypass list or policy blocking      | Review bypass list and access restriction rules.                       |
| Firefox works, Chrome does not | Chrome using system proxy vs manual | Ensure Chrome proxy settings match intended proxy (system or manual).  |

**Escalation:** If connectivity fails after correct configuration, check firewall and SafeSquid service status; contact support with access log excerpts.

## Next steps

* [Transparent Proxy](/Transparent_Proxy) for interception without client proxy configuration.
* [Connect Your Client](/Connect_Your_Client) for PAC file, system-wide, and enterprise deployment.
* Verify your setup to confirm end-to-end connectivity.


## Related topics

- [Forward proxy](/admin_guide/infrastructure_and_access/proxy_chain.md)
- [Proxy Chain](/use_cases/scaling_and_high_availability/proxy_chain.md)
- [TCP Proxy](/use_cases/scaling_and_high_availability/tcp_proxy.md)
- [Reverse Proxy](/use_cases/scaling_and_high_availability/reverse_proxy.md)
- [Choose an Architecture](/deployment/choose_an_architecture.md)
