Quickstart

From zero to a running node — including SSH, an anycast IP, and a public hostname — in twelve seconds. This page is the shortest path. Every detail it skips has its own page in the sidebar.

Install the CLI

The arv CLI is a single static binary. macOS (universal), Linux (amd64 + arm64), and Windows are supported.

$ curl -fsSL https://arveon.space/install.sh | sh
✓ arv 0.21.4 installed to /usr/local/bin/arv

Verify it's on your PATH and check the version.

$ arv --version
arveon-cli 0.21.4 (linux/amd64)

Authentication

Run arv auth login to open a browser-based device flow. For CI, mint a token in the console under Settings → Tokens and export it as ARVEON_TOKEN.

$ arv auth login
   open browser? [Y/n]
✓ authenticated as elin@tidewave.fi (org_4f7c2)

# or, in CI
$ export ARVEON_TOKEN=arv_pat_a1b2c3...
$ arv whoami
elin@tidewave.fi · org_4f7c2 · default region eu-hel-1

Your first node

This deploys a 4-vCPU Ubuntu 24.04 node in Helsinki with an anycast IP, IPv6, and your SSH public key.

$ arv compute create \
    --image  ubuntu-24.04 \
    --plan   a4 \
    --region eu-hel-1 \
    --ssh    ~/.ssh/id_ed25519.pub \
    --name   hello-arveon

✓ hello-arveon is running (12.4s)
   ipv4   185.4.118.92
   ipv6   2a0c:5240::4f12
   ssh    ssh root@185.4.118.92

SSH in. The node is reachable on the public internet, on the anycast prefix routed through your nearest peering point.

$ ssh root@185.4.118.92
Welcome to Ubuntu 24.04 LTS · arveon · eu-hel-1a
Last login: Wed Apr 29 13:42:11 2026

root@hello-arveon:~# uname -m
x86_64
root@hello-arveon:~# free -h
              total        used        free
Mem:           7.7Gi       268Mi       7.4Gi

Private VPC

Every account starts with a default VPC in each region. Resources placed in the same VPC reach each other on private addresses with no egress accounting (because there are no egress fees anywhere — but you don't traverse the public internet either).

To create a multi-region VPC:

$ arv net vpc create core \
    --regions eu-hel-1,eu-fra-1,ap-tyo-1 \
    --cidr 10.42.0.0/16

✓ vpc core created · 3 regions · WireGuard mesh up

Postgres branching

Branch a database from the live primary. The new branch is copy-on-write — only diverged pages cost storage.

$ arv pg branch staging --from prod-db
✓ staging ready (812 ms)
   psql://staging.eu-hel-1.arveon.dev:5432/db

To restore the branch to a specific second within the PITR window:

$ arv pg restore staging --at "2026-04-29T13:42:11Z"
✓ restored to 2026-04-29T13:42:11.000Z

REST API

The API speaks JSON over HTTPS at api.arveon.space. Every operation is idempotent when given an Idempotency-Key header. Rate limits are 1 000 req/s per token, with bursts allowed up to 4 000.

$ curl https://api.arveon.space/v1/regions \
    -H "Authorization: Bearer $ARVEON_TOKEN"

[
  { "code": "eu-hel-1", "city": "Helsinki", "azs": 3 },
  { "code": "eu-fra-1", "city": "Frankfurt", "azs": 3 },
  …
]

Region codes

Arveon regions follow a {continent}-{city}-{number} convention.

• eu-hel-1, eu-sto-1, eu-fra-1, eu-ams-1, eu-par-1, eu-mad-1, eu-mil-1, eu-war-1
• ap-tyo-1, ap-sin-1, ap-syd-1
• us-iad-1, us-sjc-1, sa-gru-1