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épendance | Version minimale |
|---|---|
| Node.js | >= 24.10.0 |
| pnpm | >= 10.27.0 |
| PostgreSQL | >= 15 |
| Git | toute 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 .envPrincipales variables à configurer dans le fichier .env :
| Variable | Description |
|---|---|
DATABASE_URL | URL de connexion PostgreSQL (ex: postgresql://user:pass@localhost:5432/discolaire) |
BETTER_AUTH_SECRET | Clé secrète pour l’authentification (chaîne aléatoire longue) |
NEXT_PUBLIC_APP_URL | URL publique de votre application (ex: https://mon-ecole.com) |
OPENAI_API_KEY | Clé API OpenAI (optionnel, pour les fonctionnalités IA) |
Étape 4 — Initialiser la base de données
pnpm db:push
pnpm db:seedLa 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 devEn mode production :
pnpm build
pnpm startL’application sera accessible à l’adresse configurée dans NEXT_PUBLIC_APP_URL (par défaut http://localhost:3000 ).
Première 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
