# Change the country of a Hermes cloud browser

A region error can come from a website or from a model API. Start by checking which request failed. This guide covers websites opened in Chrome.

## Confirm this is a browser task

Use these steps when Hermes controls Chrome and can run commands on that browser's machine. If the error is in a model response or provider selection, changing Chrome's IP will not fix that request.

## Start with setup

```sh
npx aluvia-cli setup
```

First 10 MB free without an account, API key or payment; then 2 USD per GB. Requires Node.js 18 or later, a usable local Chrome or Chromium browser, and command access to its host. No target page URL is required. Initial configuration can restart Chrome. [Quickstart](/docs), [setup changes](/setup), [runtime evidence](/compatibility).

## Check setup before continuing

Read the JSON result. `ready: true` confirms the browser/proxy path and upstream check, not target-site access. Follow `next` if recovery is needed. Successful setup already enables proxy traffic. If `aluvia` is not on PATH, use `npx aluvia-cli` instead.

## Check country availability

Choose the country the task needs from the current list. The command below is an example; substitute an available country or skip selection if the global pool is suitable.

```sh
aluvia geos
```

## Check the target page

Once setup is ready, select the country the website needs and reload its page. Confirm the catalog or content, and stop after a bounded retry if an IP change does not resolve the block.

```sh
aluvia proxy-on --geo US
```

## Limits

Aluvia does not change model availability or configure a browser on an inaccessible remote host. It does not change account permissions or browser fingerprints.

## Reload and verify

Reload the target using the same browser tool and check the required content. Run status and follow its `next` field. For a suspected IP refusal, rotate once and reload; stop if it still fails. For a rate limit, wait and reduce requests.

```sh
aluvia status
```

## Undo the IP change

When finished, return to the machine's IP. After setup, this keeps Chrome running.

```sh
aluvia proxy-off
```

## When the trial ends

Show the actual `claim_url` from `payment_required` to the operator. They can claim the account and buy data at 2 USD per GB. Run `aluvia auth login` to wait, inspect the response and retry. Never invent a claim URL or reveal a key. [Payment handoff](/e/payment_required).

---

Source: https://aluvia.io/geo/hermes