Documentation

Compute

Create your first virtual machine, connect to it, and automate it with the API.

Create an instance

Sign in at dash.greybull.cloud, open Compute and create a new instance. You choose:

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. You set it up yourself in the dash: open Compute and choose BGP.

  1. Link your PeeringDB account. This proves you administer your ASN.
  2. Add your ASN as a peer.
  3. Add the prefixes you want to announce. Each one needs a valid RPKI ROA for your ASN.
  4. Add a session on one of your servers, then configure its BGP daemon with the connection details shown in the dash.

Per ASN you choose what we send you: a default route only, or the full table. BGP is a free add-on: you only pay for the server.

Your sessions are with AS202585, the network Greybull runs on, at home on bgp.rodeo. Check your announcements from the outside in the looking glass, read the peering policy, or see how your routes are filtered.