Quickstart

Install, connect, and verify in 2 minutes.

Start with $1 credit. No card required.

1. Install the CLI

npm install -g shellroute

# or
brew install shellroute/tap/shellroute

Or download the binary from the releases page. Supports macOS and Linux.

Want to inspect first? The CLI source is on GitHub.

2. Log in

New accounts are created automatically on first login — no separate registration needed.

$ shellroute login
  Email: user@example.com
  Enter code sent to your email: 847291
  ✓ Logged in successfully

After login, shellroute enters interactive mode automatically.

3. Connect

Inside the interactive shell, use /connect:

● shellroute · not connected · direct traffic
~ ❯ /connect US
Connecting to US (residential)...
✓ Connected to US (United States) — New IP: 203.0.113.42

● shellroute us · 203.0.113.42
~ ❯

This terminal is now in the US. Open another shellroute session for another country; your other terminals and system processes stay direct.

4. Use

● shellroute us · 203.0.113.42
~ ❯ curl https://ipinfo.io/ip
203.0.113.42

When you're done

● shellroute us · 203.0.113.42
~ ❯ /disconnect

✓ Disconnected.

  Session:
  Duration: 4m 12s
  Data used: 12.4 MB
  Cost: $0.04
  Balance: $9.93

● shellroute · not connected · direct traffic
~ ❯

/disconnect stops routing but keeps the shell open. /exit disconnects and quits. Press Ctrl+C twice to force exit.

One-shot commands

Don't need an interactive session? Run a single command through a proxy. This is how agents and automation use shellroute:

# Agent or script: give one command its own country-specific session
shellroute run US -- curl https://httpbin.org/ip
shellroute run DE -- python agent.py
shellroute run JP -- node worker.js
shellroute run --iptype datacenter FR -- npm run test

For CI and scripts, set SHELLROUTE_API_KEY as an environment variable or pass shellroute --api-key pk_... run .... Get your key with shellroute reveal-key.

Next steps