Mise à jour et déploiement
Ce guide explique comment passer à une nouvelle version de HeelonVault, puis, pour les administrateurs, comment réaliser une installation système sous Linux. Pour une première installation sur un poste, voir QUICKSTART.fr.md.
Avant toute mise à jour
Section intitulée « Avant toute mise à jour »Être averti d’une nouvelle version
Section intitulée « Être averti d’une nouvelle version »Activez Profil & Sécurité > Mises à jour de l’application > Vérifier automatiquement pour consulter la dernière version stable publiée sur GitHub, au démarrage et au plus une fois par 24 heures. Sans consentement, aucun contrôle automatique n’est effectué. Vérifier permet un contrôle ponctuel même si cette option est désactivée.
Le bandeau Découvrir la version ouvre les notes et téléchargements officiels dans votre navigateur ; Plus tard le masque pour la session de l’application. Une connexion indisponible n’est jamais présentée comme une absence de mise à jour. GitHub reçoit l’adresse IP, mais aucune donnée de coffre, de compte ou de licence. L’application n’installe rien et ne vérifie pas elle-même les paquets : les étapes ci-dessous restent nécessaires.
Préparer l’installation
Section intitulée « Préparer l’installation »- Faites un export chiffré
.hvbde vos coffres depuis Profil & Sécurité > Gestion des données, et conservez-le hors du poste. - Notez la version installée (en-tête du journal des modifications) et lisez les sections des versions intermédiaires, en particulier les « Changements incompatibles ».
- Fermez HeelonVault.
Les évolutions du schéma de base sont appliquées automatiquement au premier lancement de la nouvelle version. Elles ne sont pas réversibles : revenir à une version antérieure impose de restaurer une sauvegarde faite avant la mise à jour.
Les mises à jour de dépendances de sécurité ne nécessitent pas, à elles seules, de recréer vos coffres, de changer votre mot de passe maître ou de renouveler votre phrase de récupération. Consultez le journal des modifications pour les éventuelles opérations propres à une livraison. Installez le paquet corrigé sur chaque poste et redémarrez aussi tout pont de rappel PSC autonome après sa mise à jour : remplacer les fichiers ne met pas à jour un processus déjà en cours.
Mettre à jour un poste
Section intitulée « Mettre à jour un poste »Téléchargez et vérifiez le nouveau paquet comme pour une première installation (sections 1 et 2 du démarrage rapide), puis :
| Système | Procédure |
|---|---|
| Windows | Lancez le nouveau .msi. Il remplace la version installée ; inutile de désinstaller d’abord. Un .msi plus ancien que la version installée est refusé. |
| macOS | Glissez la nouvelle application dans Applications et choisissez Remplacer. L’étape Gatekeeper du premier lancement est à refaire. |
| Linux (AppImage) | Remplacez l’ancien fichier .AppImage par le nouveau, puis rendez-le exécutable (chmod +x). |
Vos données ne sont pas touchées par le remplacement de l’application : elles vivent dans un dossier séparé (voir Où sont mes données ?).
AppImage : données créées avec la version 2.0.0
Section intitulée « AppImage : données créées avec la version 2.0.0 »L’AppImage 2.0.0 enregistrait sa base dans un dossier data/ relatif au dossier depuis lequel
elle était lancée (souvent le dossier personnel : ~/data/heelonvault-rust-dev.db). Les versions
suivantes utilisent ~/.local/share/heelonvault/heelonvault-rust.db. Au premier lancement, si ce
nouveau fichier n’existe pas encore, l’AppImage y copie automatiquement l’ancienne base
trouvée dans le dossier de lancement ou dans le dossier personnel. L’ancien fichier est laissé
en place : supprimez-le vous-même une fois vos secrets vérifiés.
Installation système Linux
Section intitulée « Installation système Linux »Réservée aux administrateurs qui veulent une installation dans /opt/heelonvault avec intégration
au menu des applications, ou une base partagée sur un serveur. Pour un poste individuel,
l’AppImage suffit.
Les scripts d’installation détectent la distribution (famille Debian/Ubuntu ou Fedora/RHEL/Rocky/AlmaLinux), installent les dépendances système et proposent deux profils :
| Profil | Base de données | Logs |
|---|---|---|
| Personnel (défaut) | ~/.local/share/heelonvault/heelonvault-rust.db |
~/.local/state/heelonvault/logs/ |
| Entreprise | /var/lib/heelonvault/heelonvault-rust.db |
/var/log/heelonvault/ |
Le profil Personnel partage la base de l’AppImage : les deux peuvent coexister.
Installer
Section intitulée « Installer »Prérequis : un dépôt heelonvault-core au tag voulu et le binaire construit en mode release,
en tant qu’utilisateur (voir la documentation de développement) :
cargo build --release -p heelonvault-app
# Aperçu, sans rien modifiersudo env HEELONVAULT_DRY_RUN=1 ./scripts/install.sh
# Installationsudo ./scripts/install.shLe script prend le binaire le plus récent entre target/release/heelonvault et la racine du
dépôt. Si CARGO_TARGET_DIR est défini (sudo ne le transmet pas), indiquez-le :
sudo env HEELONVAULT_BINARY="$CARGO_TARGET_DIR/release/heelonvault" ./scripts/install.sh.
Il refuse un binaire périmé : version différente de celle des sources, ou fichier source
modifié après le build, comme après un git pull (HEELONVAULT_ALLOW_STALE_BINARY=1 pour passer
outre).
Il vérifie ensuite l’intégrité du binaire si un fichier heelonvault.sha256 l’accompagne, copie
l’application et ses migrations dans /opt/heelonvault, génère le lanceur run.sh et l’entrée
de menu com.heelonvault.rust.desktop. Les scripts install-ubuntu.sh et install-rhel.sh
permettent de forcer une famille de distribution.
En profil Entreprise, le script ne configure que les chemins partagés : la publication réseau (RDS, VDI, RemoteApp, bastion…) reste à votre charge. Placez la base sur un stockage à faible latence, idéalement local au serveur d’exécution.
Mettre à jour
Section intitulée « Mettre à jour »Fermez HeelonVault, puis depuis le dépôt au nouveau tag :
cargo build --release -p heelonvault-appsudo ./scripts/install.shLa même commande installe ou met à jour. Pour une mise à jour, le script :
- affiche la version installée et celle qui va la remplacer, et propose par défaut le profil actuel (Personnel ou Entreprise) ;
- refuse de continuer si HeelonVault est ouvert ;
- installe les dépendances système, puis sauvegarde les bases détectées dans
/var/backups/heelonvault(heelonvault_user_<utilisateur>_backup_AAAAMMJJ_HHMMSS.dbouheelonvault_enterprise_backup_AAAAMMJJ_HHMMSS.db) avec une copie cohérente (sqlite3 .backup) dont l’intégrité est vérifiée ; une sauvegarde invalide interrompt tout ; - prépare la nouvelle version à côté de l’ancienne (
/opt/heelonvault.new), puis l’échange avec elle en une seule opération ; - en cas d’erreur après l’échange (icônes, lanceur, validation), restaure automatiquement la version précédente.
Jusqu’à l’étape 4, un échec laisse l’installation existante intacte. Les bases ne sont jamais modifiées par le script : seule l’application les migre, à son premier lancement.
Contrôle après mise à jour :
test -x /opt/heelonvault/heelonvault && test -x /opt/heelonvault/run.sh && echo OKstat -c "%a %n" ~/.local/share/heelonvault/heelonvault-rust.db # attendu : 600Revenir à la version précédente
Section intitulée « Revenir à la version précédente »# 1. Réinstaller la version précédente (dépôt au tag précédent, binaire correspondant)sudo ./scripts/install.sh
# 2. Restaurer la sauvegarde faite avant la mise à jourls -lth /var/backups/heelonvault/cp /var/backups/heelonvault/<sauvegarde>.db ~/.local/share/heelonvault/heelonvault-rust.dbDésinstaller
Section intitulée « Désinstaller »sudo ./scripts/remove.shLes données et les sauvegardes ne sont supprimées que si vous le confirmez explicitement.
Migration depuis l’ancienne version Python (0.4)
Section intitulée « Migration depuis l’ancienne version Python (0.4) »HeelonVault ne lit ni ne modifie jamais les données de l’ancienne application Python. Pour les reprendre, exportez-les en CSV, puis importez ce fichier depuis Profil & Sécurité > Gestion des données > Importer des données (CSV) :
# Données dans le dossier par défaut (~/.local/share/passwordmanager), profil donné./scripts/export-legacy-v0.4-to-csv.py --profile <profil> --output legacy_export.csv
# Ou chemins explicites (déploiement partagé, par exemple sous /var/lib/heelonvault-shared)./scripts/export-legacy-v0.4-to-csv.py \ --db-path <chemin>/passwords_<profil>.db \ --salt-path <chemin>/salt_<profil>.bin \ --output legacy_export.csvLe fichier CSV contient vos mots de passe en clair : supprimez-le de façon sûre dès l’import terminé.
