Installation

Hérédité est déjà installée sur cet ordinateur

Vous utilisez la version installée avec le paquet Debian. Il n'y a rien d'autre à installer : l'application fonctionne sans connexion Internet et se lance depuis le menu des applications, rubrique Éducation.

  • Mettre à jour : si Hérédité a été installée depuis le dépôt SambaEdu (ou celui de votre établissement), les mises à jour arrivent avec celles du système. Sinon, téléchargez la dernière version du paquet et installez-la comme la première fois.
  • Désinstaller : sudo apt remove heredite

Hérédité fonctionne déjà sur cet ordinateur

Vous utilisez une copie d'Hérédité ouverte depuis un dossier (archive). Elle fonctionne sans connexion Internet : il n'y a rien d'autre à installer. Pour la mettre à jour, téléchargez à nouveau l'archive et remplacez le dossier.

Vous voulez utiliser Hérédité sur un autre appareil : téléphone, tablette, ordinateur à la maison ?

Ces méthodes se suivent sur l'appareil concerné, depuis le site en ligne : bio.forge.apps.education.fr/heredite/installation.html.

Choisissez votre système : la méthode recommandée est en haut, les autres sont repliées en dessous. Toutes les méthodes permettent d'utiliser Hérédité sans connexion Internet, et aucune ne collecte de données.

L'application est installée : vous l'utilisez en ce moment.
Votre navigateur permet d'installer Hérédité en un clic.

Système détecté : (vous pouvez choisir un autre onglet).

Recommandé

Debian, Ubuntu, Linux Mint, LMDE : dépôt APT

Hérédité s'installe pour tous les utilisateurs du poste, apparaît dans le menu des applications (rubrique Éducation) et se met à jour automatiquement avec le reste du système. Il faut les droits d'administrateur. Ouvrez un terminal et copiez les deux commandes.

1. Ajouter le dépôt SambaEdu (une seule fois)

sudo apt install -y curl && \
sudo install -d -m 0755 /etc/apt/keyrings && \
sudo curl -fsSL https://deb.sambaedu.org/sambaedu.gpg.key -o /etc/apt/keyrings/sambaedu.gpg && \
sudo chmod 644 /etc/apt/keyrings/sambaedu.gpg && \
echo "deb [signed-by=/etc/apt/keyrings/sambaedu.gpg] http://deb.sambaedu.org/debian trixie se4XP main" | sudo tee /etc/apt/sources.list.d/sambaedu.list && \
sudo apt update

2. Installer Hérédité

sudo apt install heredite
Fedora, Arch, openSUSE… : ces distributions n'utilisent pas APT. Utilisez l'application web (première méthode ci-dessous).

Autres méthodes

Application web (toutes les distributions)

Hérédité s'installe depuis le navigateur, sans droits d'administrateur, et se met à jour toute seule lorsque vous êtes connecté.

GNOME Web (appelé aussi Epiphany, disponible dans la logithèque et sur Flathub) : la solution la mieux intégrée.

Ouvrez le menu , puis Installer le site comme application web.

Firefox (y compris Firefox ESR, installé par défaut sur Debian) : la fonction existe mais doit être activée à la main.

  1. tapez about:config dans la barre d'adresse et acceptez l'avertissement ;
  2. recherchez browser.taskbarTabs.enabled et passez-la à true (si elle n'existe pas, choisissez Booléen et cliquez sur +) ;
  3. quittez complètement Firefox, puis relancez-le ;
  4. sur cette page, cliquez sur l'icône à droite de la barre d'adresse (Ajouter l'onglet à la barre des tâches : sous Linux, elle ajoute l'application au menu).

Chromium : le bouton Installer l'application apparaît en haut de cette page. L'application est rangée dans une catégorie de menu « Chromium », moins bien intégrée au système.

Ranger l'icône dans la catégorie Éducation (GNOME Web, Firefox)

GNOME Web et Firefox ne reprennent pas la catégorie déclarée par le site : l'icône peut apparaître dans Autres. Pour la ranger dans Éducation, tapez dans un terminal :

for f in $(grep -l "^Name=H.*r.*dit" ~/.local/share/xdg-desktop-portal/applications/*.desktop ~/.local/share/applications/*webapp*.desktop 2>/dev/null); do
  sed -i '/^Categories=/d; /^\[Desktop Entry\]/a Categories=Education;' "$f"
  case "$f" in */xdg-desktop-portal/*) ln -sf "$f" ~/.local/share/applications/ ;; esac
  echo "Modifié : $f"
done
update-desktop-database ~/.local/share/applications 2>/dev/null

Fermez puis rouvrez votre session. Évitez les éditeurs de menus comme MenuLibre, qui peuvent remplacer le lien créé par GNOME Web par une copie. Refaites la manipulation après une réinstallation.

Paquet .deb seul, sans dépôt

Même installation que par le dépôt, mais sans mise à jour automatique : pour mettre à jour, téléchargez et installez à nouveau le paquet.

Télécharger le paquet .deb

Dernière version :

Ouvrez le fichier avec l'installateur de paquets, ou tapez dans un terminal, depuis le dossier de téléchargement :

sudo apt install ./heredite_latest_all.deb
Archive (poste sans Internet, clé USB)

Téléchargez l'archive, décompressez-la et ouvrez public/index.html avec un navigateur. Rien à installer, fonctionne avec tous les navigateurs.

Archive .tar.gz
Gestionnaires de dépôt APT : intégrer Hérédité automatiquement

Chaque nouvelle version est publiée automatiquement, avec un fichier de description lisible par un programme :

  • latest.json : version, nom du fichier, empreinte sha256, taille et adresses de téléchargement du dernier paquet ;
  • registre de paquets : toutes les versions, à adresse permanente, pour revenir en arrière.

Exemple de latest.json :

{
  "package": "heredite",
  "version": "26.11.3.16.7-1",
  "filename": "heredite_26.11.3.16.7-1_all.deb",
  "sha256": "032e0cb5da6560fdfedae9e734ae0461268a44fc4b64628b803763739e2e7abc",
  "size": 1805123,
  "url": "https://forge.apps.education.fr/api/v4/projects/968/packages/generic/heredite/…",
  "url_pages": "https://bio.forge.apps.education.fr/heredite/telechargement/…",
  "commit": "…",
  "date": "2026-11-03T16:07:00-10:00"
}

La version est la date et l'heure du commit (AA.M.J.H.MIN-1) : elle augmente toujours. Le paquet est en Architecture: all, avec une seule dépendance, xdg-utils.

Script prêt à l'emploi (reprepro ou aptly)

Le script heredite-apt-sync lit latest.json, ne fait rien si votre dépôt contient déjà cette version ou une plus récente, et sinon télécharge le paquet, contrôle sa taille, son empreinte et son en-tête Debian, puis l'ajoute au dépôt. Il est silencieux quand il n'y a rien à faire.

# Installation
sudo apt install curl jq
B=https://forge.apps.education.fr/bio/heredite/-/raw/master/packaging/depot-apt
sudo curl -fsSL -o /usr/local/bin/heredite-apt-sync "$B/heredite-apt-sync"
sudo chmod 755 /usr/local/bin/heredite-apt-sync
sudo curl -fsSL -o /etc/default/heredite-apt-sync "$B/heredite-apt-sync.conf.exemple"
sudoedit /etc/default/heredite-apt-sync   # OUTIL=reprepro ou aptly, chemins, distribution

# Essai sans rien modifier
sudo -u <utilisateur-du-depot> DRY_RUN=1 VERBOSE=1 heredite-apt-sync

# Vérification toutes les heures
echo '23 * * * * <utilisateur-du-depot> /usr/local/bin/heredite-apt-sync' \
  | sudo tee /etc/cron.d/heredite-apt-sync

Mode d'emploi complet : packaging/depot-apt/README.md.

Désinstaller

Paquet (dépôt ou .deb seul) :

sudo apt remove heredite

Retirer aussi le dépôt SambaEdu :

sudo rm /etc/apt/sources.list.d/sambaedu.list /etc/apt/keyrings/sambaedu.gpg && sudo apt update

Application web :

  • GNOME Web : tapez about:applications, puis Supprimer en face d'Hérédité ;
  • Firefox : dans la fenêtre de l'application, cliquez sur le bouton d'application web de la barre d'adresse ; si c'est la dernière fenêtre, l'application est désinstallée ;
  • Chromium : menu de l'application, puis Désinstaller Hérédité….
Recommandé

FreeBSD, OpenBSD, NetBSD, GhostBSD : application web

Installez Hérédité depuis un navigateur qui le permet : GNOME Web (Epiphany) ou Chromium, tous deux disponibles dans les paquets de votre système (par exemple sous FreeBSD, en administrateur : pkg install epiphany ou pkg install chromium).

  • GNOME Web : menu , puis Installer le site comme application web.
  • Chromium : bouton Installer l'application en haut de cette page, ou icône d'installation à droite de la barre d'adresse.

Autres méthodes

Application web avec Firefox

Firefox est disponible dans les paquets de tous les BSD (par exemple sous FreeBSD : pkg install firefox ou pkg install firefox-esr). Comme sous Linux, sa fonction d'installation doit être activée à la main :

  1. tapez about:config dans la barre d'adresse et acceptez l'avertissement ;
  2. recherchez browser.taskbarTabs.enabled et passez-la à true (si elle n'existe pas, choisissez Booléen et cliquez sur +) ;
  3. quittez complètement Firefox, puis relancez-le ;
  4. sur cette page, cliquez sur l'icône à droite de la barre d'adresse.

Méthode non vérifiée sous BSD. Si l'icône n'apparaît pas, utilisez GNOME Web ou Chromium, ou ouvrez l'archive avec Firefox.

Archive (poste sans Internet, clé USB)

Téléchargez l'archive, décompressez-la et ouvrez public/index.html avec n'importe quel navigateur, y compris Firefox.

Archive .tar.gz
Désinstaller
  • GNOME Web : tapez about:applications, puis Supprimer en face d'Hérédité ;
  • Chromium : menu de l'application, puis Désinstaller Hérédité… ;
  • Firefox : dans la fenêtre de l'application, cliquez sur le bouton d'application web de la barre d'adresse ; si c'est la dernière fenêtre, l'application est désinstallée ;
  • Archive : supprimez le dossier.
Recommandé

Application web avec Firefox

  1. Ouvrez cette page dans Firefox ou Fennec (version de Firefox du magasin libre F-Droid).
  2. Ouvrez le menu , puis choisissez Installer ou Ajouter à l'écran d'accueil.

Le bouton vert « Installer l'application » n'apparaît pas dans Firefox : c'est normal, passez par le menu.

Autres méthodes

Avec Chrome ou Edge

Le bouton Installer l'application apparaît en haut de cette page. Sinon : menu puis Installer l'application ou Ajouter à l'écran d'accueil.

Désinstaller

Appui long sur l'icône d'Hérédité, puis Supprimer ou Désinstaller.

Recommandé

Application web avec Safari

  1. Ouvrez cette page dans Safari.
  2. Touchez le bouton Partager .
  3. Choisissez Sur l'écran d'accueil, puis Ajouter.

Sur iPhone et iPad, Apple impose son propre moteur à tous les navigateurs : il n'existe pas de solution entièrement libre sur ces appareils.

Autres méthodes

Désinstaller

Appui long sur l'icône d'Hérédité, puis Supprimer l'app.

Recommandé

Application web avec Safari

  1. Ouvrez cette page dans Safari (macOS 14 Sonoma ou plus récent).
  2. Menu Fichier, puis Ajouter au Dock.

Hérédité s'ouvre alors dans sa propre fenêtre, comme une application, et fonctionne sans connexion Internet.

Autres méthodes

Avec Chromium (ou Chrome, Edge)

Le bouton Installer l'application apparaît en haut de cette page ; vous pouvez aussi cliquer sur l'icône d'installation à droite de la barre d'adresse. Firefox ne permet pas encore d'installer une application web sur macOS.

Archive (poste sans Internet, clé USB)

Téléchargez l'archive, décompressez-la et ouvrez public/index.html avec n'importe quel navigateur.

Archive .zip
Désinstaller
  • Safari : dans le Finder, ouvrez le dossier Applications de votre dossier personnel et placez Hérédité dans la corbeille ;
  • Chromium : menu de l'application, puis Désinstaller Hérédité….
Recommandé

Application web avec Firefox

  1. Ouvrez cette page dans Firefox (version 143 ou plus récente).
  2. Cliquez sur l'icône d'application web dans la barre d'adresse.
Télécharger Firefox

Autres méthodes

Avec Chromium, Edge ou Chrome

Le bouton Installer l'application apparaît en haut de cette page. Sinon : icône d'installation à droite de la barre d'adresse, ou menu puis Installer Hérédité (Edge : Applications → Installer ce site en tant qu'application).

Archive (poste sans Internet, clé USB)

Téléchargez l'archive, décompressez-la et ouvrez public\index.html avec n'importe quel navigateur.

Archive .zip
Désinstaller

Paramètres → Applications → Applications installées, puis Hérédité → Désinstaller.

Recommandé

Archive : fonctionne partout

Téléchargez l'archive, décompressez-la et ouvrez public/index.html avec un navigateur. Rien à installer.

Autres méthodes

ChromeOS (Chromebook)

Le bouton Installer l'application apparaît en haut de cette page ; vous pouvez aussi cliquer sur l'icône d'installation à droite de la barre d'adresse.

Autre système avec un navigateur récent

Si votre navigateur propose d'installer un site comme application (icône dans la barre d'adresse ou entrée de menu), Hérédité peut s'installer de cette façon. Sinon, utilisez l'archive ou le site en ligne.

Pourquoi recommander des navigateurs libres ?

Firefox, GNOME Web et Chromium sont des logiciels libres : leur code source est public, chacun peut l'étudier, le modifier et le redistribuer. Google Chrome, Microsoft Edge et Apple Safari sont propriétaires : on ne peut pas vérifier ce qu'ils font, et ils transmettent par défaut de nombreuses informations à leur éditeur (télémétrie, synchronisation avec un compte).

L'application Hérédité elle-même ne collecte aucune donnée et reste conforme au RGPD, quel que soit le navigateur utilisé.