Skip to content

Proxy indicator and text #24

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
gregpr07 wants to merge 2 commits into
base: main
Choose a base branch
from
Draft

Proxy indicator and text #24

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
69ad029
docs: emphasize default proxy behavior
cursoragent Mar 11, 2026
917d3b3
docs: use warning callout for default proxy
cursoragent Mar 11, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions docs/cloud/guides/proxies-and-stealth.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -57,9 +57,9 @@ const result = await client.run("Get the price of iPhone 16 on amazon.de", {

Common country codes: `us`, `gb`, `de`, `fr`, `jp`, `au`, `br`, `in`, `kr`, `ca`, `es`, `it`, `nl`, `se`, `sg`.

<Info>
<Warning>
The default is always `us`. This applies to auto-sessions (`run()` without a `session_id`), manually created sessions, and browser sessions — unless you explicitly set a different country code.
</Info>
</Warning>

## Custom proxy

Expand Down Expand Up @@ -97,10 +97,10 @@ Proxy is a session-level setting. All tasks in the same session use the same pro
## Disabling proxies

<Warning>
Disabling the proxy is not recommended. Residential proxies are a core part of Browser Use's stealth infrastructure and significantly reduce the chance of being blocked or fingerprinted. Only disable them if you have a specific reason (e.g. testing against localhost, or your target site allowlists your server IP).
Only disable proxies for localhost testing or sites that allowlist your server IP. They reduce blocks and fingerprinting.
</Warning>

To opt out of the built-in proxy, pass `proxyCountryCode` as `null` explicitly. This works for sessions, tasks (via `sessionSettings`), and browser sessions.
To disable the built-in proxy, set `proxyCountryCode` to `null` on sessions, tasks (via `sessionSettings`), or browser sessions.

<CodeGroup>
```python Python
Expand Down