Documentation

Getting started

Where you start depends on what you’re running.

1. For free hosting, log in at console.revenact.io.
2. For a VM, order at billing.revenact.io.
3. For a dedicated or GPU server, email sales@revenact.io.

Connecting

VMs and dedicated servers use SSH:

ssh root@your-server-address

Free hosting servers have a console in the browser, plus SFTP for files.

Authentication

The API uses bearer tokens. Create one in your account settings, and send it with each request.

Authorization: Bearer $REVENACT_TOKEN

Create a VM

Send a plan, a location and an image.

curl -X POST https://api.revenact.io/v1/vms \
  -H "Authorization: Bearer $REVENACT_TOKEN" \
  -d '{"plan":"general-2","location":"frankfurt","image":"ubuntu-24.04"}'

const res = await fetch("https://api.revenact.io/v1/vms", {
  method: "POST",
  headers: { Authorization: `Bearer ${token}` },
  body: JSON.stringify({ plan: "general-2", location: "frankfurt", image: "ubuntu-24.04" }),
});

import requests

res = requests.post(
    "https://api.revenact.io/v1/vms",
    headers={"Authorization": f"Bearer {token}"},
    json={"plan": "general-2", "location": "frankfurt", "image": "ubuntu-24.04"},
)

Plans and locations

Plan IDs look like ryzen-4 or general-2. Location IDs are the lowercase city name, like frankfurt.

Rate limits

Back off and retry when you get a 429 response.