Getting started

Gheima builds and runs your services, databases, and buckets, and bills you in dirhams. On every plan, your services, databases and buckets run in the Casablanca region (ma-1) by default. Data you keep on ma-1 stays at rest in Morocco. This guide takes you from sign-in to a live deployment.

Sign in#

There is no password. Sign in with GitHub or with a magic link sent to your email.

1. 1

   Open the sign-in page

   Go to the dashboard and you land on “Welcome back”.

2. 2

   Continue with GitHub

   Click "Continue with GitHub" and authorize Gheima. This also lets you pick repositories to deploy later.

3. 3

   Or use a magic link

   Enter your email and click “Email me a sign-in link”. Open the link within 15 minutes to sign in.

Create a project and deploy#

A project groups related services. Creating one, adding a service, and deploying all happen on a single form.

1. 1

   New project

   Click “New project”, give it a name, and optionally a description.

2. 2

   Pick a repository

   Choose a GitHub repository (or paste a Git URL), then set the branch (default main) and port (default 3000).

3. 3

   Deploy

   Click "Create & deploy". Gheima detects your stack with Nixpacks, builds it, and deploys it.