Compute guide | Greybull

Create an instance

A plan: vCPUs, memory and SSD storage. You can change this later.
An operating system: Debian 12/13, Ubuntu 24.04/26.04 LTS, AlmaLinux 9/10, Rocky Linux 9/10, Fedora 44, openSUSE Leap 16.0, Arch Linux or NixOS 26.05 (see all distributions). Prefer something else? Boot from netboot.xyz or your own ISO.
A username and your SSH key: the user is created with passwordless sudo during the first boot.

The instance is deployed in minutes with full root access.

Connect

On first boot, cloud-init creates your user with your SSH key and sets up the hostname and network, so you can log in as soon as the instance is running:

ssh your-username@203.0.113.10

Locked yourself out, or broke the network config? Every instance has a web console on its detail page in the dash, so you always have a way back in.

Manage instances with the API

Create an API key in the dash under API settings, then send it in the X-API-Key header.

List your instances:

curl https://dash.greybull.cloud/api/v1/compute \
  -H "X-API-Key: $API_KEY"

Power actions (start, stop, restart, shutdown):

curl -X POST https://dash.greybull.cloud/api/v1/compute/101/actions \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"action":"restart"}'

Also available: GET /api/v1/compute/plans for available plans, GET /api/v1/compute/{vmId} for a single instance, DELETE to remove one, and /api/v1/compute/{vmId}/ptr-records to manage reverse DNS.

Scale up

Upgrade your instance from the dash without downtime: scale vCPUs, RAM and storage at any time. You only pay the difference for the remaining period.

Bring your own IP space

You can announce your own IPv4/IPv6 prefixes from your instances over BGP. We verify your ASN via PeeringDB and validate prefixes with RPKI. BGP is available on request: contact us to get it enabled for your account.