# Tunnelbyte

> WireGuard tunnels by the minute. CLI-first, ephemeral, pay-per-use.

## Docs

- [GET /v1/ip/{addr}](https://docs.tunnelbyte.dev/api/ip.md): IP attribution lookup. Public, rate-limited, CORS-open.
- [API overview](https://docs.tunnelbyte.dev/api/overview.md): The same primitive over HTTP.
- [GET /v1/regions](https://docs.tunnelbyte.dev/api/regions.md): List active exit regions.
- [Sessions](https://docs.tunnelbyte.dev/api/sessions.md): Create and inspect tunnel sessions.
- [GET /v1/usage](https://docs.tunnelbyte.dev/api/usage.md): Current 24-hour quota snapshot for the authenticated account.
- [tunnelbyte billing](https://docs.tunnelbyte.dev/cli/billing.md): Open the billing portal.
- [tunnelbyte login](https://docs.tunnelbyte.dev/cli/login.md): Link this device to your existing account.
- [tunnelbyte logout](https://docs.tunnelbyte.dev/cli/logout.md): Delete the cached token on this device.
- [CLI overview](https://docs.tunnelbyte.dev/cli/overview.md): Every command, every flag.
- [tunnelbyte regions](https://docs.tunnelbyte.dev/cli/regions.md): List available exit regions.
- [tunnelbyte signup](https://docs.tunnelbyte.dev/cli/signup.md): Upgrade your anonymous tier to a free account.
- [tunnelbyte token](https://docs.tunnelbyte.dev/cli/token.md): Print the cached API token to stdout.
- [tunnelbyte [region]](https://docs.tunnelbyte.dev/cli/tunnel.md): Bring up a WireGuard tunnel to a regional exit node.
- [tunnelbyte upgrade](https://docs.tunnelbyte.dev/cli/upgrade.md): Add a card; switch to pay-as-you-go.
- [tunnelbyte version](https://docs.tunnelbyte.dev/cli/version.md): Print version, commit, and build date.
- [Abuse policy](https://docs.tunnelbyte.dev/concepts/abuse.md): What we don't allow, how to report, what happens.
- [Logging posture](https://docs.tunnelbyte.dev/concepts/logging.md): Exactly what we store. And what we don't.
- [Routing modes](https://docs.tunnelbyte.dev/concepts/routing.md): Per-app (default) vs system-wide (--all) vs wrapped child.
- [Security & signing](https://docs.tunnelbyte.dev/concepts/security.md): How to verify the Tunnelbyte binary and apt repository, and what we sign with.
- [Tiers](https://docs.tunnelbyte.dev/concepts/tiers.md): Anonymous → free account → paid. What each gets you.
- [Use it in CI and scripts](https://docs.tunnelbyte.dev/guides/ci-and-scripts.md): Drop tunnelbyte into GitHub Actions, Python, Node, or any script that respects HTTPS_PROXY.
- [Introduction](https://docs.tunnelbyte.dev/introduction.md): WireGuard tunnels by the minute. CLI-first, ephemeral, pay-per-use.
- [Quickstart](https://docs.tunnelbyte.dev/quickstart.md): Install, run, and tear down your first tunnel in under a minute.

## Optional

- [Landing page](https://tunnelbyte.dev)
- [GitHub](https://github.com/tunnelbyte/tunnelbyte)
- [Status](https://status.tunnelbyte.dev)