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 or HTTPS
• 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 you’re using HTTP or HTTPS (Socks5 proxies are not supported)
• Try connecting to the proxy from a local machine to verify it works outside your network