Documentation | Greybull

Quickstart

From zero to a running instance in three steps.

Create an account

Sign up at dash.greybull.nl

Create an API token

Dashboard → Settings → API Tokens

Deploy your first instance

curl -X POST https://dash.greybull.nl/api/v1/compute \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"type":"cx-s","region":"nl-ens-1","image":"ubuntu-24.04"}'

By product

In-depth guides per product line.

Compute

Create VMs, choose instance types, manage SSH keys and network configuration.

Webhosting

Manage sites via Plesk, create databases and configure SSL certificates.

Hosted DNS

Create zones, manage records via the API and activate DNSSEC.

API reference

All Greybull services are available via a RESTful API. Authentication is handled via API tokens that you create in the dashboard. DNS and domains can also be managed from your terminal with the greybull CLI.

Example: list instances
curl -H "Authorization: Bearer $GREYBULL_TOKEN" \
  https://dash.greybull.nl/api/v1/compute/instances

Response
{
  "instances": [{
    {
      "id": "i-abc123",
      "type": "cx-s",
      "region": "nl-ens-1",
      "status": "running",
      "ip": "185.123.45.67"
    }
  ]
}

CLI: DNS & domains from your terminal
npx greybull login
npx greybull dns zones
npx greybull dns add example.nl A www 203.0.113.20
npx greybull domains check mycompany --tlds nl,com

Need help?

Can't figure it out? Get in touch with our team.

Get started quickly.