> ## Documentation Index
> Fetch the complete documentation index at: https://hyperbrowser.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Multi-Region Support

> Deploy browser sessions across multiple geographic regions for optimal performance and compliance

Hyperbrowser supports deploying browser sessions across multiple geographic regions worldwide. This allows you to optimize for latency and improve performance for your users.

## Available Regions

Hyperbrowser currently supports the following regions:

| Region Code   | Location                | Description                      |
| ------------- | ----------------------- | -------------------------------- |
| `us-central`  | United States (Central) | Optimal for North American users |
| `us-east`     | United States (East)    | East coast US region             |
| `us-west`     | United States (West)    | West coast US region             |
| `europe-west` | Europe (West)           | Optimal for European users       |
| `asia-south`  | Asia (South)            | Optimal for Asian users          |

## Why Use Multi-Region Support?

**Reduced Latency**: Deploy sessions closer to your target websites or end users to minimize network latency and improve response times.

**Geographic Testing**: Test how websites behave from different geographic locations, useful for geo-restricted content or region-specific features.

**Load Distribution**: Distribute workloads across multiple regions for better scalability and reliability.

## Quick Start

Specify the region when creating a session:

<CodeGroup>
  ```typescript Node.js theme={null}
  import { Hyperbrowser } from "@hyperbrowser/sdk";

  const client = new Hyperbrowser({
    apiKey: process.env.HYPERBROWSER_API_KEY,
  });

  async function main() {
    // Create session in Europe
    const session = await client.sessions.create({
      region: "europe-west",
    });

    console.log("Session ID:", session.id);
    console.log("WebSocket:", session.wsEndpoint);
  }

  main();
  ```

  ```python Python theme={null}
  from hyperbrowser import Hyperbrowser
  from hyperbrowser.models import CreateSessionParams
  import os

  client = Hyperbrowser(api_key=os.environ["HYPERBROWSER_API_KEY"])

  # Create session in Europe
  session = client.sessions.create(
      params=CreateSessionParams(region="europe-west")
  )

  print(f"Session ID: {session.id}")
  print(f"WebSocket: {session.ws_endpoint}")
  ```

  ```bash cURL theme={null}
  curl -X POST https://api.hyperbrowser.ai/api/session \
    -H "x-api-key: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "region": "europe-west"
    }'
  ```
</CodeGroup>

## Region Selection Best Practices

### Combine with Proxy Settings

You can also combine region selection with proxy settings from the same geographic area:

<CodeGroup>
  ```typescript Node.js theme={null}
  // European session with European proxy
  const session = await client.sessions.create({
    region: "europe-west",
    useProxy: true,
    proxyCountry: "DE", // Germany
    useStealth: true,
  });
  ```

  ```python Python theme={null}
  from hyperbrowser.models import CreateSessionParams

  # European session with European proxy
  session = client.sessions.create(
      params=CreateSessionParams(
          region="europe-west",
          use_proxy=True,
          proxy_country="DE",  # Germany
          use_stealth=True
      )
  )
  ```
</CodeGroup>

<Tip>
  Matching your session region with your proxy country can reduce latency and make your traffic patterns appear more natural.
</Tip>

## Troubleshooting

### High Latency

If you're experiencing high latency:

1. **Check region selection**: Ensure you're using the region closest to your target
2. **Verify network connectivity**: Test your connection to the region
3. **Consider proxy settings**: Proxy routing can add latency

### Session Creation Timeout

If session creation times out in a specific region:

1. **Try a different region**: Some regions may be experiencing high load
2. **Check region status**: Contact support for region availability
3. **Increase timeout**: Adjust your client timeout settings

## API Reference

For complete API details on the `region` parameter, see:

* [Create Session API Reference](/api-reference/create-new-session)
* [Session Parameters Documentation](/sessions/parameters)

## Next Steps

<CardGroup cols={2}>
  <Card title="Proxy Configuration" icon="shield" href="/sessions/proxy">
    Combine regions with proxy settings for optimal performance
  </Card>

  <Card title="Session Parameters" icon="brackets-curly" href="/sessions/parameters">
    Explore all available session configuration options
  </Card>

  <Card title="Stealth Mode" icon="user-secret" href="/sessions/stealth">
    Learn about anti-detection features
  </Card>

  <Card title="Static IPs" icon="location-dot" href="/sessions/static-ips">
    Use static IPs with regional sessions
  </Card>
</CardGroup>