Pricing and calculator
Every plan per hour and per month, add-ons and a cost calculator.
GOLDNET Cloud for developers
Script your servers with a REST API and scoped tokens, drive them from the goldnet command line, or describe them as code with Terraform.
Everything on this page is built; GOLDNET Cloud opens for self-service soon. Until then, request access and we set it up for you by hand.
Your servers, as JSON
curl -H "Authorization: Bearer $GOLDNET_TOKEN" \
https://cloud.vcom.co.za/v2/instances
{"instances": [
{"id": "<id>", "label": "web-1",
"plan": "vc-2c-4g", "status": "running"}
]}Developers
The same things the control panel does, from your terminal or your pipeline.
REST API with curl
# list your servers
curl -H "Authorization: Bearer $GOLDNET_TOKEN" \
https://cloud.vcom.co.za/v2/instances
# create one (a retry with the same key never makes two)
curl -X POST https://cloud.vcom.co.za/v2/instances \
-H "Authorization: Bearer $GOLDNET_TOKEN" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"region":"dbn1","plan":"vc-2c-4g","image":"ubuntu-24.04","label":"web-1","ssh_key_ids":["<key-id>"]}'
# reboot it
curl -X POST -H "Authorization: Bearer $GOLDNET_TOKEN" \
-H "Content-Type: application/json" -d '{"type":"reboot"}' \
https://cloud.vcom.co.za/v2/instances/<id>/actionsgoldnet command-line tool
goldnet auth <token> # saved with file mode 600
goldnet catalog # regions, plans, images, apps
goldnet servers create web-1 --plan vc-2c-4g --image ubuntu-24.04 --ipv6
goldnet servers create blog --plan vc-1c-1g --app wordpress
goldnet servers resize <id> vc-4c-8g
goldnet ssh-keys add laptop ~/.ssh/id_ed25519.pub
goldnet volumes create data-1 100 --server <id>
goldnet billing # balance, burn rate, this month
goldnet servers --json # raw JSON for scriptsmain.tf
terraform {
required_providers {
goldnetcloud = { source = "goldnet/goldnetcloud" }
}
}
provider "goldnetcloud" {} # reads GOLDNET_TOKEN
resource "goldnetcloud_ssh_key" "me" {
name = "laptop"
public_key = file("~/.ssh/id_ed25519.pub")
}
resource "goldnetcloud_instance" "web" {
label = "web-1"
plan = "vc-2c-4g"
image = "ubuntu-24.04" # or app = "wordpress"
ssh_key_ids = [goldnetcloud_ssh_key.me.id]
tags = ["web"]
}
output "ip" { value = goldnetcloud_instance.web.ipv4 }HTTP and JSON
A few endpoints
GET https://cloud.vcom.co.za/v2/catalog # public: plans, images, regions
GET https://cloud.vcom.co.za/v2/instances
POST https://cloud.vcom.co.za/v2/instances
POST https://cloud.vcom.co.za/v2/instances/<id>/resize
GET https://cloud.vcom.co.za/v2/operations/<id>goldnet CLI
Infrastructure as code
Build and use the provider
go build -o ~/.terraform.d/goldnet/terraform-provider-goldnetcloud .
cat > ~/.terraformrc <<'EOF'
provider_installation {
dev_overrides { "goldnet/goldnetcloud" = "/home/you/.terraform.d/goldnet" }
direct {}
}
EOF
export GOLDNET_TOKEN=gnc_...FAQ
On the API page of the control panel, once your account is open. A token is shown once: copy it then.
Not yet. The API page in the panel lists the endpoints, and the CLI and Terraform provider show every call.
Yes. Give the token a list of allowed networks and it is refused from anywhere else.
dbn1: Durban, in Teraco's Durban data centre.
Keep exploring
Every plan per hour and per month, add-ons and a cost calculator.
Try a server before you commit. We set it up with you.
WordPress, Docker, Node.js, MinIO, Gitea, WireGuard and LAMP.
PostgreSQL, MySQL and Redis with daily backups.
Clusters on our servers, with no cluster fee.
Volumes, snapshots and automatic daily backups.
Firewalls, private networks, IPv6, reserved IPs, load balancers.
Our teams in Gqeberha and Durban answer Monday to Friday, 09:00 to 18:00. Our WhatsApp assistant answers any time, and the network is monitored around the clock.