Installer Orbit
Déployer Orbit avec Docker Compose sur un serveur Linux, puis le connecter au SSO de l'entreprise.
Historique des révisions
| Version | Date | Auteur | Modification |
|---|---|---|---|
| 1.0 | 02/10/2026 | Hugo Martin | Création |
| 1.1 | 10/11/2026 | Camille Roux | Connexion SSO (étape 5), dépannage |
1. Prérequis
Vérifiez chaque point avant de commencer :
- Un serveur Linux (Debian 12 ou Ubuntu 24.04) avec 2 vCPU, 4 Go de RAM et 20 Go de disque.
- Docker 27 ou plus et le plugin Docker Compose installés.
- Un accès SSH avec un compte membre du groupe
docker. - Un nom de domaine pointant vers le serveur, par exemple
orbit.exemple.fr. - Un client OpenID Connect créé dans votre fournisseur d'identité (identifiant et secret transmis par MasterIT).
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
-
Récupérer Orbit
Connectez-vous au serveur en SSH, puis clonez le dépôt dans
/opt/orbit:bashsudo mkdir -p /opt/orbit && sudo chown "$USER" /opt/orbit git clone https://gitlab.com/masterit-infra/mit-orbit.git /opt/orbit cd /opt/orbit -
Configurer l'environnement
Copiez le fichier d'exemple, puis renseignez au minimum
ORBIT_URLetDATABASE_URL:bashcp .env.example .env nano .env # ORBIT_URL=https://orbit.exemple.fr -
Démarrer les services
Lancez les conteneurs, puis appliquez les migrations de la base de données :
bashdocker compose up -d docker compose exec app bin/console doctrine:migrations:migrate --no-interactionLe premier démarrage télécharge les images : comptez quelques minutes selon la connexion.
-
Vérifier la page de connexion
Ouvrez
https://orbit.exemple.frdans un navigateur. La page de connexion s'affiche :
Figure 1 — Page de connexion d'Orbit. -
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 :
Figure 2 — Tableau de bord après la première connexion.
3. Vérifications
docker compose psaffiche tous les services à l'étatrunning.- La page de connexion répond en HTTPS, sans alerte de certificat.
- La connexion SSO ouvre le tableau de bord.
4. Dépannage
| Symptôme | Cause probable | Action |
|---|---|---|
| Erreur 502 | Le conteneur app démarre encore | Attendez une minute, puis docker compose logs app |
| « redirect_uri invalide » | URL de retour absente du client OIDC | Ajoutez https://orbit.exemple.fr/* au client |
| Migrations en échec | DATABASE_URL incorrecte | Corrigez .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 .