Integrations / Proxy setups / A proxy per profile

A different proxy for every profile.

Profiles stay apart only if their exits do. Browz gives each profile its own proxy, checks it at every Start, and never falls back to your own connection when a proxy fails.

Shellbrowz create "Client A" --proxy "Paris ISP" browz update "Client B" --proxy "Frankfurt static 1" browz list # each profile with its proxy

Setup

Set it up.

  1. By hand

    Pick a proxy in the new-profile panel, or change it later in the profile drawer. The list shows which profiles already use each proxy.

  2. By policy, for many profiles

    Select profiles and choose Assign proxies: balanced, one-to-one, round-robin or seeded random. Preview the plan, apply it, and roll it back before launch if needed. New profiles can also take the least-used proxy automatically.

  3. From the command line

    Shellbrowz create "Client A" --proxy "Paris ISP" browz update "Client B" --proxy "Frankfurt static 1" browz list # each profile with its proxy

Example

Pair a proxy list with profiles in a shell loop.

Each line of proxies.txt is a name, a host and a port. The loop adds the proxy, checks it, and creates a profile that uses it.

proxies.txtparis-1 203.0.113.10 8080 paris-2 203.0.113.11 8080 paris-3 203.0.113.12 8080
pair.sh#!/bin/sh set -eu while read -r name host port; do browz proxy add "$name" --host "$host" --port "$port" --scheme http browz check "$name" browz create "Shop $name" --proxy "$name" done < proxies.txt

Good to know

Notes and tips.

  • On the Installed Chrome engine every profile needs a proxy, whatever the setting says.
  • Turn on Only launch with a working proxy in Settings to also refuse profiles that have no proxy at all.
  • Leave a profile’s timezone, language and WebRTC on automatic: Browz sets them from where the proxy really exits, measured at each check, so the profile does not contradict its own address.
  • Bring proxies from any provider: Browz supports HTTP, HTTPS, SOCKS4, SOCKS5 and SSH.
  • A profile whose proxy fails its exit check is refused at Start. It never falls back to your own connection.
  • A proxy changes where a profile connects from, not what a site allows. Use each site only as its terms allow; our acceptable use policy applies whatever the exit.

FAQ

A proxy per profile and Browz.

What happens if a profile’s proxy is down?

Start is refused with the reason. Browz never starts the profile on your own connection instead.

Can two profiles use the same proxy?

Yes, and the proxy list shows it. They then share an exit IP; give each its own if they should not look related.

Do synced profiles keep their proxy on another computer?

Yes. Proxies sync with your account, end-to-end encrypted, so a profile opens with the same proxy on every computer you sign in on.

Get started

Download Browz. Every task, its own browser.

Then, on macOS or Linux, put the MCP server on your PATHcurl -fsSL https://gobrowz.com/agents/install.sh | sh

For Mac, Windows and Linux. Free for 5 profiles. Paid plans from $4.99 a month, with a 14-day refund on your first payment.