Skip to Content
Installation

Installation

Ce guide vous explique comment installer et configurer Discolaire sur votre serveur.

Prérequis

Avant de commencer, assurez-vous d’avoir les éléments suivants installés :

DépendanceVersion minimale
Node.js>= 24.10.0
pnpm>= 10.27.0
PostgreSQL>= 15
Gittoute version récente

Étape 1 — Cloner le dépôt

git clone https://github.com/discolaire/discolaire.git cd discolaire

Étape 2 — Installer les dépendances

pnpm install

Étape 3 — Configurer les variables d’environnement

Copiez le fichier d’exemple et renseignez vos valeurs :

cp .env.example .env

Principales variables à configurer dans le fichier .env :

VariableDescription
DATABASE_URLURL de connexion PostgreSQL (ex: postgresql://user:pass@localhost:5432/discolaire)
BETTER_AUTH_SECRETClé secrète pour l’authentification (chaîne aléatoire longue)
NEXT_PUBLIC_APP_URLURL publique de votre application (ex: https://mon-ecole.com)
OPENAI_API_KEYClé API OpenAI (optionnel, pour les fonctionnalités IA)

Étape 4 — Initialiser la base de données

pnpm db:push pnpm db:seed

La commande db:push applique le schéma Prisma à votre base de données. La commande db:seed crée les données initiales (utilisateur administrateur, paramètres par défaut).

Étape 5 — Démarrer l’application

En mode développement :

pnpm dev

En mode production :

pnpm build pnpm start

L’application sera accessible à l’adresse configurée dans NEXT_PUBLIC_APP_URL (par défaut http://localhost:3000 ).

Première connexion

Page de connexion

Après le démarrage, accédez à la page de connexion. Utilisez les identifiants créés par le script de seed :

  • Email : admin@discolaire.com (modifiable dans le fichier de seed)
  • Mot de passe : défini dans le fichier .env

Important : Changez le mot de passe administrateur immédiatement après la première connexion via Administration → Mon compte.

Configuration de l’école

Après la première connexion, accédez à Administration → Mon École pour configurer :

  • Le nom et les informations de l’établissement
  • L’année scolaire en cours
  • Les cycles, niveaux et sections
  • Les paramètres de notation

Consultez la section Administration pour les détails.

Applications complémentaires

Discolaire est disponible en plusieurs versions :

  • Application web — Accessible depuis n’importe quel navigateur
  • Application desktop — Version Electron pour Windows, macOS et Linux
  • Application mobile — Application React Native pour iOS et Android

Tableau de bord après connexion