---
title: 'Annexe – Installation et maintenance'
url: 'https://docs.educcloud.fr/bacagora/enseignant/annexe-installation-et-maintenance'
markdown: 'https://docs.educcloud.fr/bacagora/enseignant/annexe-installation-et-maintenance.md'
date: '2026-11-20'
description: "Annexe – Installation et maintenance Cette annexe s'adresse à la personne qui administre le serveur. Application PHP 8.1 ou supérieur, sans dépendance externe ; base SQLite (par défaut) ou MySQL / MariaDB. Configuration : copier config.dist.php en config.php (base de données, fuseau horaire, nombr…"
---

# Annexe – Installation et maintenance

Cette annexe s'adresse à la personne qui administre le serveur.

- Application PHP 8.1 ou supérieur, sans dépendance externe ; base SQLite (par défaut) ou MySQL / MariaDB.
- Configuration : copier config.dist.php en config.php (base de données, fuseau horaire, nombre de tâches par jour et délai d'échéance par défaut).
- Installation de la base et du premier compte enseignant (administrateur) : php bin/install.php prof motdepasse Prénom Nom.
- Les comptes des autres enseignants se créent ensuite dans l'application (Administration › Enseignants) ; la même commande reste possible en ligne de commande.
- Moteur quotidien (cron) : 45 6 \* \* \* php /var/www/bacagora/bin/tick.php.
- Après une mise à jour du code, la base est mise à niveau automatiquement au premier accès (ou par php bin/migrate.php).
- Sauvegarde cohérente de la base SQLite, même pendant l'utilisation : php bin/backup.php fichier.sqlite.
- Vérification après une modification : php bin/test-simulation.php 30.
- Export du référentiel en JSON : php bin/referentiel-json.php \[--sans-exercices\] \[fichier.json\].

**Simulateur DPAE** : le serveur télécharge la liste des services de santé au travail depuis l'open data de l'Urssaf (jeu sst\_dpae) et la conserve 7 jours dans var/sst\_dpae.json (nouvel essai 6 heures après un échec) ; le dossier var/ doit donc être accessible en écriture. Si le serveur n'a pas accès à open.urssaf.fr, téléchargez le fichier CSV ou JSON (data.gouv.fr, « Services de prévention et de santé au travail (SPST) ») et indiquez son chemin dans config.php : 'sst\_url' => 'var/sst\_dpae.csv'. Avec 'sst\_urssaf' => false, aucun appel réseau n'est fait (services fictifs, un par département).

**Plusieurs établissements** : un même code peut servir de nombreux établissements, chacun avec sa propre base et ses comptes, à l'adresse https://\\<etab>.\\<domaine>/. Les scripts de création, de mise à jour et de sauvegarde sont dans deploy/multi-instance (voir MULTI-INSTANCE.md).

Le fichier README fourni avec l'application détaille l'installation dans un conteneur LXD et l'ajout d'une nouvelle organisation.

**Connexion par l'ENT et console d'administration.** La connexion par l'ENT (Authentik : groupes \\<code>:bacagora:eleve|prof|admin, liens d'inscription) est décrite dans deploy/authentik/SSO.md. La console d'administration (création des lycées et des pools, suivi des établissements et des serveurs) a son propre LISEZMOI.md.

---

[← Conseils pédagogiques et questions fréquentes](https://docs.educcloud.fr/bacagora/enseignant/conseils-pedagogiques-et-questions-frequentes) · [Sommaire](https://docs.educcloud.fr/bacagora/enseignant)

---

## Navigation

- Parent: [Manuel enseignant](https://docs.educcloud.fr/bacagora/enseignant.md)
- Previous: [Conseils pédagogiques et questions fréquentes](https://docs.educcloud.fr/bacagora/enseignant/conseils-pedagogiques-et-questions-frequentes.md)
