Skip to content

Quickstart: hcloud

hcloud is a small binary shipped in the release tarball (and built from crates/cloud-cli). It talks to CLOUDD_URL and remembers your session in ~/.config/hyphae-cloud/.

Terminal window
export CLOUDD_URL=https://infra-hyphae.run
hcloud signup --email [email protected] --password 'at least 8 characters' --invite-code "$INVITE_CODE" # the code is required on the hosted deployment
hcloud project create --name demo
# ID STATE CREATED NAME
# prj_221db12762ce352b stopped 2026-09-15T13:35:58 demo
hcloud project wakeup prj_221db12762ce352b
hcloud key create prj_221db12762ce352b --label app # prints the hyp1_ key once and stores it for `capabilities`
hcloud capabilities prj_221db12762ce352b # GET /v2/capabilities, HYPRSP01 decoded, Native field names
hcloud project head prj_221db12762ce352b # live probe while running

Storage, realtime and functions:

Terminal window
hcloud storage buckets create prj_221db12762ce352b assets
hcloud storage put prj_221db12762ce352b assets ./hello.txt hello.txt
hcloud realtime publish prj_221db12762ce352b orders created '{"order": 42}'
hcloud fn deploy prj_221db12762ce352b hello ./hello.js
hcloud fn invoke prj_221db12762ce352b hello '{"name": "cli"}'
hcloud fn secret set prj_221db12762ce352b API_KEY --file ./secret.txt # never echoed back

A snapshot needs the engine asleep:

Terminal window
hcloud project sleep prj_221db12762ce352b
hcloud snapshot create prj_221db12762ce352b --label first
hcloud snapshot list prj_221db12762ce352b

The full command list: hcloud reference.