# Getting started

> Sign in, create a project and deploy your first service.

Source: https://gheima.ma/docs/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. **Open the sign-in page** — Go to the dashboard and you land on “Welcome back”.
2. **Continue with GitHub** — Click "Continue with GitHub" and authorize Gheima. This also lets you pick repositories to deploy later.
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. **New project** — Click “New project”, give it a name, and optionally a description.
2. **Pick a repository** — Choose a GitHub repository (or paste a Git URL), then set the branch (default main) and port (default 3000).
3. **Deploy** — Click "Create & deploy". Gheima detects your stack with Nixpacks, builds it, and deploys it.

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

> Note: If you have no repository yet, create the project without one. Connect a repository later from the service settings.

---

All docs: https://gheima.ma/docs.md