Change the country of a Hermes cloud browser

This page as markdown: https://aluvia.io/geo/hermes.md

Updated 2026-09-08 · Aluvia

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

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, setup changes, runtime evidence.

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.

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.

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.

aluvia status

Undo the IP change

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

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.