Skip to content

Quick start

This guide takes you from a fresh account to a deployed, public app in three steps. Pick either the dashboard or the REST API.

Open deploy.ghaymah.systems and sign in (or click Create an account).

Open Apps → Deploy App, then:

  1. Details — name your app (lowercase letters, numbers, hyphens) and pick an image (e.g. nginx).
  2. Resources — choose a size (g3.small is free) and instance count.
  3. Advanced — leave empty to accept defaults.

Ghaymah provisions the app and assigns a public URL automatically:

https://my-app-web-7f3a9c.hosted.ghaymah.systems

That’s it. Your app is live.

Terminal window
curl -X POST https://api.cumin.dev/projects \
-H "Authorization: Bearer $ADMIN_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "name": "my-project" }'
# { "id": "…", "token": "…" }
Terminal window
curl -X POST https://api.cumin.dev/apps \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"project_id": "…",
"name": "my-app",
"image": "docker.io/nginx:latest",
"ports": [{ "name": "web", "number": 80 }],
"cpu": 256,
"memory": 512,
"instances": 1,
"hibernated": false
}'
# { "id": "…" }
Terminal window
curl https://api.cumin.dev/apps \
-H "Authorization: Bearer $TOKEN"

The app’s ports[].hostname holds its public URL, assigned automatically.

  • An app (a container) was created inside a project.
  • It’s reachable at a public URL immediately, and its logs stream from the dashboard or GET /logs/{id}.