Proxy setup

A proxy is what gives each account its own IP. In Orbe every profile routes through its own proxy, so accounts on the same computer never share an address. Using a proxy is optional, but for account work it is strongly recommended.

How it works

Each profile gets its own local gateway on 127.0.0.1. The browser only ever talks to that plain local proxy — no username or password. Your real proxy credentials stay inside Orbe's own process and are handed to the upstream proxy there; they are never exposed to the page or to a browser extension.

This matters: the common alternative — an extension that fills in the proxy login — shows up in the extension list and has to run inside the page. Orbe's local gateway avoids both. To the site, it looks like an ordinary direct connection.

Add a proxy

Open a profile's Proxy field and paste one line:

host:port:user:pass        # proxy with a login
host:port                  # open proxy (no login)

That's it — Orbe wires the local gateway for you. You can change a profile's proxy later from the same field.

Third-party proxies: up to 20 profiles

IP2.VN rental proxies are optional and have no limit on profiles. A proxy from any other provider (third-party) can be used on up to 20 profiles per account. The count covers all your computers together; profiles on an IP2.VN port or with no proxy don't count.

• On the Proxies page click Third-party proxy profiles… to choose which profiles keep their third-party proxy. The box shows “{n} selected on this computer · {m} used on your other computers · limit 20”, with Save and Close.
• The first time you open 1.0.17, Orbe keeps the 20 most recently opened profiles that use a third-party proxy, then shows the box. With 20 or fewer it doesn't ask.
• Over the limit, setting another third-party proxy is refused: “Up to 20 profiles per account can use a third-party proxy. Use an IP2.VN port or remove a third-party proxy from another profile.”
• Setting a third-party proxy needs an internet connection, because Orbe checks your account's limit: “Setting a third-party proxy needs an internet connection (Orbe checks your account's limit). Try again online.”
• When you open a profile, Orbe asks the server (a few seconds). If the server says the profile is outside your 20, it runs without its proxy. If Orbe can't reach the server (offline or an error), the profile still uses its proxy, for up to 7 days.
• After more than 7 days offline, a profile outside your chosen 20 won't open: “Orbe has been offline for more than 7 days, so it can't confirm this profile is one of your 20 third-party proxy profiles. Connect to the internet, then open it again.”

In automation, a flow's Set proxy block takes either port_id (an IP2.VN port you rent) or host + port (third-party, counted toward the limit). The Local API and MCP profile lists, open results and each batch or schedule result row carry a proxy_disabled flag (true / false).

HTTP or SOCKS5

Both work, from any provider. Paste the credentials the provider gave you.

If you have both an HTTP and a SOCKS5 endpoint from the same provider, either is fine — pick one and keep it for the profile.

IP2.VN proxies (optional)

Any provider works with the host:port:user:pass line above (third-party proxies are limited to 20 profiles per account; IP2.VN ports have no limit). As a convenience, if you rent your proxies from IP2.VN, you can connect them with an account token instead of copying each port's credentials by hand.

• Open Settings → IP2.VN proxy (optional) and paste your account token (it starts with ip2a_). You paste it once.
• Orbe then reads your rented ports, fills each profile's proxy for you, and can rotate the IP and renew a port from inside the app.
• Orbe never asks for your IP2.VN login password — only the token, which you can revoke at any time from your IP2.VN dashboard.

Rotate IP on open

For a profile on a rented IP2.VN port you can tick Rotate IP on open. It is off by default — off means the profile opens as before and keeps its IP. You'll find the checkbox in three places, shown only for rented IP2.VN ports: the New profile box (after you choose IP2.VN rental), the Change proxy box (the Proxy… button, saved as soon as you tick it), and the profile's details under Network.

When it is on, every open — the Open button, the SDK or the MCP server — first gets a new IP from the port, waits until the new IP is in place, and only then starts the browser. IP2.VN rotation takes ~25–30 s; each port can rotate once every 3 minutes.

If Orbe can't get a new IP, the browser does not open. A Couldn't get a new IP box offers:

• Open with current IP — open anyway, on the IP the port has now;
• Wait Ns and rotate — shown when the port changed IP less than 3 minutes ago; Orbe counts down, then rotates and opens (close the box to cancel);
• Cancel.

Rotating needs your IP2.VN token in Settings → IP2.VN proxy (optional). It applies only to rented IP2.VN ports: profiles with your own proxy or no proxy ignore it. To rotate a port in the middle of a run instead, use the Rotate proxy IP block.

Choosing a proxy

• Residential or mobile (4G) proxies are recommended for account work — they look like ordinary home or phone connections.
• Datacenter IPs are cheaper but easier for a platform to flag; use them with care.
• Match the country to the account. An account that has always looked Vietnamese suddenly appearing from another country is a signal in itself.
• Keep a profile on a stable IP. Constant, erratic IP changes look less human than a steady residential address.

One IP per profile

Give each profile its own IP. Two accounts sharing an address links them together — exactly what separate machines are meant to prevent.

WebRTC & leaks

WebRTC can reveal a real IP even when a page loads through a proxy. Orbe forces WebRTC through the proxy, so a page sees only the proxy's address, not the machine behind it. There is nothing to configure — it is on for every profile.

Rotating the IP

You can give a profile a fresh IP without closing it — useful between accounts or when an IP goes stale:

• In a workflow — the Rotate proxy IP block (see Blocks & Actions) rotates mid-run and can store the new IP in a variable.
• On open — for a rented port, tick Rotate IP on open to get a new IP each time the profile opens (see Rotate IP on open).

Rotation needs a proxy whose provider supports it (most residential and mobile proxies do). Rotate one profile at a time rather than all at once.

Checks before a run

When you automate, Orbe checks the proxy before opening the browser: it must be reachable and, where it can be determined, in the expected country. A run on a dead or wrong-country IP is more expensive than one that never started, so Orbe stops early with a clear message rather than opening onto the wrong address.

Troubleshooting

Next: Profiles · Running accounts at scale · FAQ.