Platform overview
Ghaymah is a cloud platform with managed services you drive from the dashboard or a simple REST API. Deploy apps, then attach the storage, databases, and secrets they need.
The pieces
Section titled “The pieces”| Service | What it does | Create with |
|---|---|---|
| Apps | Run a containerized app with a public URL, logs, and scaling | Dashboard or POST /apps |
| Static Sites | Host a static website from a ZIP, no build config | Dashboard (drag-and-drop) |
| S3 storage | Managed object storage with buckets and scoped access keys | POST /s3/buckets |
| Volumes | Persistent disk you can mount into any app | POST /volumes |
| Managed PostgreSQL | A production Postgres database, no ops required | POST /db/postgres |
| Secrets | Store sensitive key/value values safely | POST /secrets |
| Pull secrets | Store private registry credentials for your apps | POST /secrets/pull |
| GenAI | One OpenAI-compatible API for every model | https://genai.ghaymah.systems |
Everything is grouped into projects, and every resource lives in exactly one project. A project is your isolation boundary — apps, buckets, volumes, databases, and secrets in one project can see each other; resources in different projects cannot.
Around these services sit a few account-level features: Teams to share a project with teammates, Integrations to connect external services like Docker Hub, and the Store of one-click templates.
How it fits together
Section titled “How it fits together”A typical app uses several services at once:
┌─────────────────────────────┐ │ Project │ │ │ Public URL ─────────▶│ App (container) │ │ │ │ │ ├── mounts a Volume │ (files that survive restarts) │ ├── reads from S3 │ (objects, uploads, assets) │ ├── connects to Postgres │ (database) │ └── injects Secrets │ (API keys, credentials) └─────────────────────────────┘You can build this from the dashboard, the REST API, or both. The dashboard handles the app with a three-step form; the REST API gives you programmatic control over every service for scripts, CI, and your own tooling.
Two ways to drive Ghaymah
Section titled “Two ways to drive Ghaymah”1. The dashboard
Section titled “1. The dashboard”Best for seeing everything at a glance. Sign in at deploy.ghaymah.systems and deploy apps, create buckets, volumes, and databases from the browser. Take the Dashboard tour for a guided walkthrough.
2. The REST API
Section titled “2. The REST API”Best for automation. Every resource is a JSON API at https://api.cumin.dev:
curl https://api.cumin.dev/health \ -H "Authorization: Bearer $TOKEN"The API covers apps, S3 buckets & keys, volumes, managed PostgreSQL, and secrets. Read the REST API overview to get started, then jump to the service you need.
Projects and authentication
Section titled “Projects and authentication”Before you create anything you need a project and a token:
- Project — a named container for your resources.
- Token — a bearer credential scoped to one or more projects.
When using the REST API directly, you create a project and mint a token first — the REST API overview walks through it. From the dashboard, the project is created for you when you sign in.
Next steps
Section titled “Next steps”- New to Ghaymah? Start with the quick start.
- Deploying? See Deploying your app.
- Building on the API? Read the REST API overview.
- Pick a service below to go deeper.