# Docs

How an agent installs Aluvia, when to turn it on, and the pages that explain the rest.

## The command

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

Runs once per machine. Needs Node.js 18 or later. If `aluvia` is not on PATH, prefix every command with `npx aluvia-cli`. Every later command prints JSON on stdout with a `next` field.

## What it is

Aluvia is a local CLI and proxy daemon. An AI agent running in a cloud VM installs it, turns it on, and keeps working when a site blocks the VM's datacenter IP.

Residential and mobile IPs are global, from carriers around the world. Sticky sessions last up to 30 minutes.

The first setup starts a free trial from an install id on the machine. No account, no API key, and no human in the loop. Paid data is 2 USD per GB.

## When to use it

Use Aluvia when a page returns 403, shows a CAPTCHA, shows a Cloudflare or Access Denied interstitial, reports unusual traffic, or throttles the request. Do not use it for a normal login wall.

Omit `--geo` to use the global pool — every country. `aluvia proxy-on --geo US` picks a country. Run `aluvia geos` for the list.

## Other pages

- `/setup` — Setup Guide: what setup changes on the machine, and how to undo it.
- `/pricing` — $2/GB, first 10 MB free. Bring your own proxy is free.
- `/unblock` — one page per block signal.
- `/llms.txt` — the whole site as plain text, for an agent.

---

Source: https://aluvia.io/docs