IP allowlisting

• Pass network traffic through allowlisted infrastructure
• Control your browser’s IP address and location
• Comply with internal security policies, firewalls, and access controls

How to route Browserbase through your VPN

1. Deploy a VPN or proxy server in your trusted network
2. Allowlist that IP in your firewall, backend, or third-party system
3. Pass the proxy config into your Browserbase session
4. Browserbase routes browser traffic through your proxy

Custom proxy configuration

import { Browserbase } from "@browserbasehq/sdk";

const bb = new Browserbase({ apiKey: process.env.BROWSERBASE_API_KEY! });

async function createSessionWithCustomProxies() {
  const session = await bb.sessions.create({
    proxies: [
      {
        type: "external",
        server: "http://...",
        username: "user",
        password: "pass",
      },
    ],
  });
  return session;
}

const session = await createSessionWithCustomProxies();

from browserbase import Browserbase
import os

bb = Browserbase(api_key=os.environ["BROWSERBASE_API_KEY"])


def create_session_with_custom_proxy():
    session = bb.sessions.create(
        proxies=[
            {
                "type": "external",
                "server": "http://...",
                "username": "user",
                "password": "pass",
            },
        ]
    )
    return session


session = create_session_with_custom_proxy()

Key requirements

• Your proxy must support HTTP, HTTPS, or SOCKS5
• It must be accessible from Browserbase (public IP or via tunnel)
• You must allow traffic from Browserbase to your proxy (firewall, VPN config, etc.)

Troubleshooting

• Make sure your proxy server is publicly accessible or properly tunneled
• Confirm the proxy IP is correctly allowlisted in your system
• Check the proxy authentication credentials
• Ensure the proxy URL uses http://, https://, socks5://, or socks5h:// (Browserbase doesn’t support SOCKS4 proxies)
• Try connecting to the proxy from a local machine to verify it works outside your network