Skip to content

Démarrage rapide

Lancez pipel8ne en local en moins de 5 minutes avec Docker Compose.

Prérequis

Étape 1 — Cloner le dépôt

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

Étape 2 — Créer le fichier d'environnement

bash
cp .env.example .env

Ouvrez .env et renseignez les deux valeurs obligatoires :

env
JWT_SECRET=<générer ci-dessous>
SECRETS_ENCRYPTION_KEY=<générer ci-dessous>

Générez des valeurs sécurisées avec Node.js :

bash
# JWT_SECRET — collez le résultat dans .env
node -e "console.log(require('crypto').randomBytes(64).toString('hex'))"

# SECRETS_ENCRYPTION_KEY — doit faire exactement 64 caractères hex (32 octets)
node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"

WARNING

Ne commitez jamais .env dans le contrôle de version. Ces secrets protègent les données de vos utilisateurs.

Étape 3 — Démarrer la stack

bash
docker compose up

Docker télécharge les images, démarre MongoDB et lance le backend. Attendez le message :

pipel8ne-backend  | Server listening on http://0.0.0.0:3000

Étape 4 — Créer votre compte

Ouvrez votre navigateur sur http://localhost:3000.

Vous serez invité à vous inscrire. Renseignez votre nom, email et mot de passe — ce premier compte devient l'administrateur.

TIP

Après la création de votre compte, allez dans Paramètres → Administration pour désactiver l'inscription publique si vous ne souhaitez pas que d'autres personnes s'inscrivent.

Étape 5 — Créer votre premier pipeline

  1. Cliquez sur Nouveau projet et donnez-lui un nom
  2. Ouvrez le projet et cliquez sur Nouveau pipeline
  3. Cliquez n'importe où sur le canvas pour ajouter votre premier stage

Vous êtes prêt à construire. Continuez avec le guide utilisateur pour un guide complet.


Ce qui tourne

ServiceURLDescription
Frontend + APIhttp://localhost:3000L'application pipel8ne
MongoDBlocalhost:27017Base de données (interne, non exposée par défaut)

Arrêter la stack

bash
docker compose down

Pour supprimer également toutes les données (volume MongoDB) :

bash
docker compose down -v

Released under the MIT License.