Getting started

Sign in, create a project, and deploy your first app in a few minutes.

Gheima runs your apps, databases, and storage on Morocco’s own cloud. This guide takes you from zero to a live deployment.

Sign in#

There is no password to remember — sign in with GitHub or an email magic link.

  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” to 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, and ships it.

✦ Your service opens on a gheima.ma subdomain with HTTPS, streaming build logs as it goes live. Add a custom domain any time.

No repo yet? Create the project without one and connect a repository later from the service settings.