Déploiement Docker

La méthode recommandée pour déployer pipel8ne est Docker Compose. Cela démarre la stack complète (MongoDB + backend + frontend) en une seule commande.

Prérequis

• Docker Engine 24+ et Docker Compose v2
• Un serveur ou VM avec au moins 512 Mo de RAM et 1 cœur CPU

Installation

1. Cloner le dépôt

git clone https://github.com/ogb4n/pipel8ne.git
cd pipel8ne

2. Créer le fichier d'environnement

cp .env.example .env

Renseignez les valeurs obligatoires dans .env. Voir Variables d'environnement.

3. Builder le frontend

cd webapp
npm install
npm run build
cd ..

4. Démarrer la stack

docker compose up -d
docker compose ps

L'application est disponible sur http://localhost:3000.

5. Créer le premier compte admin

Ouvrez le navigateur et inscrivez-vous. Le premier compte reçoit automatiquement le rôle admin.

---

Mettre à jour

git pull
cd webapp && npm install && npm run build && cd ..
docker compose pull
docker compose up -d

---

Sauvegarder les données

Les données MongoDB sont stockées dans un volume Docker nommé. Pour sauvegarder :

docker exec pipel8ne-mongo mongodump \
  --uri "mongodb://pipel8ne:<password>@localhost:27017/pipel8ne?authSource=admin" \
  --out /tmp/backup

docker cp pipel8ne-mongo:/tmp/backup ./backup-$(date +%Y%m%d)

---

Arrêter la stack

docker compose down          # conserver les données
docker compose down -v       # supprimer également les volumes (⚠ détruit toutes les données)