MasterIT
Mode opératoire
Réf. MIT-MOP-001 · v1.1
Mode opératoire

Installer Orbit

Déployer Orbit avec Docker Compose sur un serveur Linux, puis le connecter au SSO de l'entreprise.

Produit
Orbit 2.4
Public
Administrateur système du client
Durée
45 minutes environ
Rédigé par
Camille Roux, MasterIT
Date
10 novembre 2026
Version
1.1

Historique des révisions

VersionDateAuteurModification
1.002/10/2026Hugo MartinCréation
1.110/11/2026Camille RouxConnexion SSO (étape 5), dépannage

1. Prérequis

Vérifiez chaque point avant de commencer :

Le secret du client OpenID Connect ne doit jamais être envoyé par courriel ni écrit dans ce document : il est transmis par le coffre-fort de mots de passe de MasterIT.

2. Procédure

  1. Récupérer Orbit

    Connectez-vous au serveur en SSH, puis clonez le dépôt dans /opt/orbit :

    bash
    sudo mkdir -p /opt/orbit && sudo chown "$USER" /opt/orbit
    git clone https://gitlab.com/masterit-infra/mit-orbit.git /opt/orbit
    cd /opt/orbit
  2. Configurer l'environnement

    Copiez le fichier d'exemple, puis renseignez au minimum ORBIT_URL et DATABASE_URL :

    bash
    cp .env.example .env
    nano .env            # ORBIT_URL=https://orbit.exemple.fr
  3. Démarrer les services

    Lancez les conteneurs, puis appliquez les migrations de la base de données :

    bash
    docker compose up -d
    docker compose exec app bin/console doctrine:migrations:migrate --no-interaction

    Le premier démarrage télécharge les images : comptez quelques minutes selon la connexion.

  4. Vérifier la page de connexion

    Ouvrez https://orbit.exemple.fr dans un navigateur. La page de connexion s'affiche :

    Page de connexion d'Orbit avec le bouton « Se connecter avec MasterIT SSO »
    Figure 1 — Page de connexion d'Orbit.
  5. Se connecter avec le SSO

    Cliquez sur Se connecter avec MasterIT SSO et identifiez-vous avec votre compte d'entreprise. Le premier compte connecté devient propriétaire de l'espace ; le tableau de bord s'affiche :

    Tableau de bord d'Orbit : indicateurs, jalons et activité GitLab d'un projet
    Figure 2 — Tableau de bord après la première connexion.

3. Vérifications

4. Dépannage

SymptômeCause probableAction
Erreur 502Le conteneur app démarre encoreAttendez une minute, puis docker compose logs app
« redirect_uri invalide »URL de retour absente du client OIDCAjoutez https://orbit.exemple.fr/* au client
Migrations en échecDATABASE_URL incorrecteCorrigez .env, puis docker compose up -d

Le problème persiste ? Contactez le support MasterIT : support@masterit.fr.

5. Validation

Installation réalisée le sur le serveur .

Réalisé par — nom, date et signature
Validé par le client — nom, date et signature