# Prise en main

> Connectez-vous, créez un projet et déployez votre premier service.

Source: https://gheima.ma/fr/docs/getting-started

Gheima construit et fait tourner vos services, bases de données et buckets, et vous facture en dirhams. Sur tous les plans, vos services, bases de données et buckets tournent par défaut dans la région de Casablanca (ma-1). Les données que vous gardez sur ma-1 restent au repos au Maroc. Ce guide vous mène de la connexion à un déploiement en ligne.

### Se connecter

Aucun mot de passe à retenir : connectez-vous avec GitHub ou un lien magique par e-mail.

1. **Ouvrez la page de connexion** — Rendez-vous sur le tableau de bord : vous arrivez sur « Bon retour ».
2. **Continuer avec GitHub** — Cliquez sur « Continuer avec GitHub » et autorisez Gheima. Vous pourrez ainsi choisir plus tard les dépôts à déployer.
3. **Ou utilisez un lien magique** — Saisissez votre e-mail et cliquez sur « Envoyez-moi un lien de connexion ». Ouvrez le lien dans les 15 minutes pour vous connecter.

### Créer un projet et déployer

Un projet regroupe des services liés. Le créer, y ajouter un service et déployer se font sur un seul formulaire.

1. **Nouveau projet** — Cliquez sur « Nouveau projet », donnez-lui un nom et, si vous voulez, une description.
2. **Choisissez un dépôt** — Sélectionnez un dépôt GitHub (ou collez une URL Git), puis définissez la branche (par défaut main) et le port (par défaut 3000).
3. **Déployez** — Cliquez sur « Créer et déployer ». Gheima détecte votre stack avec Nixpacks, la construit et la déploie.

> Result: Votre service s’ouvre sur un sous-domaine gheima.ma en HTTPS, avec les logs de build en direct pendant la mise en ligne. Ajoutez un domaine personnalisé quand vous voulez.

> Note: Si vous n’avez pas encore de dépôt, créez le projet sans dépôt. Connectez-en un plus tard depuis les paramètres du service.

---

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