Quickstart
1. Sign in
Open cloud.tngat.com. A fresh install asks you to create the platform administrator on the one-time setup screen (name, email and password — it runs once and cannot be repeated); after that you sign in with GitHub or the credentials you created. Everyone else is invited to an organization.
2. Create an organization
An organization is your tenant boundary. The first sign-in asks for one: give it a name — the slug (used in URLs, immutable) is derived from it — and you can add or switch organizations anytime from the org switcher.
3. Get a key
Everything below authenticates with an API key, and this is where you create one: Organization → API keys → Create key. Give it a name you will recognise later (shopfront-cli), and either let it act as your own account or bind it to a service account — for automation that is the better choice, because a service account can be disabled without touching anyone's access.
The secret is shown once. Export it and check it works:
export TNGAT_API_KEY=tngatc_...
curl https://api.tngat.com/api/auth/me -H "Authorization: Bearer $TNGAT_API_KEY"That call returns your user, the organization the key is scoped to, and the role it carries. If it answers 401, the key is wrong or revoked; 403 means the key is valid but not permitted, and the response names the permission it wanted.
4. Create a project
Projects group the services that belong to one application. slug is required and is what appears in URLs, so choose it deliberately — it cannot be changed later:
curl -X POST https://api.tngat.com/api/projects \
-H "Authorization: Bearer $TNGAT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"slug": "shopfront", "name": "Shopfront", "port": 3000}'Creating a project also provisions its production, preview and development environments, each with its own variable scope. An organization holds 25 projects by default; the Limits & quotas page lists every cap and how a platform administrator raises one.
5. Add a service
Every service is created *inside* a project:
curl -X POST https://api.tngat.com/api/v1/databases \
-H "Authorization: Bearer $TNGAT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"projectId": "prj_123",
"name": "orders",
"engine": "postgres",
"version": "16",
"cpu": "500m",
"memoryMb": 1024,
"storageGb": 10,
"replicas": 1
}'Provisioning is asynchronous: the response returns immediately with a PENDING resource and a connection string appears once the operator reports the database ready.
6. Deploy
Open Projects → New project, turn on Deploy an app service now and connect a repository, or push to a branch that matches an environment rule and the webhook takes over.