Installation et démarrage rapide
Ce guide couvre l’installation de HeelonVault sur votre poste et le premier lancement, jusqu’à votre premier secret enregistré. Comptez une dizaine de minutes.
1. Télécharger
Section intitulée « 1. Télécharger »Les paquets sont publiés sur la page Releases GitHub. Choisissez le fichier correspondant à votre système :
| Système | Fichier | Configuration requise |
|---|---|---|
| Windows | heelonvault-windows-x86_64-vX.Y.Z.msi |
Windows 10 ou 11, 64 bits, droits administrateur pour l’installation |
| macOS | heelonvault-macos-aarch64-vX.Y.Z.dmg |
macOS 13 Ventura ou plus récent, Mac Apple Silicon (M1 et suivants) |
| Linux | heelonvault-linux-x86_64-vX.Y.Z.AppImage |
Distribution 64 bits récente (x86_64) |
Téléchargez aussi le fichier .sha256 du même nom : il sert à vérifier que le paquet n’a pas
été altéré.
2. Vérifier le téléchargement
Section intitulée « 2. Vérifier le téléchargement »Placez le paquet et son fichier .sha256 dans le même dossier, puis :
- Linux :
sha256sum -c heelonvault-linux-x86_64-vX.Y.Z.AppImage.sha256 - macOS :
shasum -a 256 -c heelonvault-macos-aarch64-vX.Y.Z.dmg.sha256 - Windows (PowerShell) : comparez la valeur affichée par
Get-FileHash .\heelonvault-windows-x86_64-vX.Y.Z.msi -Algorithm SHA256au contenu du fichier.sha256.
La commande doit répondre OK (Linux, macOS) ou afficher la même empreinte (Windows). Dans le
cas contraire, ne lancez pas le paquet et téléchargez-le à nouveau.
3. Installer
Section intitulée « 3. Installer »- Double-cliquez sur le fichier
.msi. - Le paquet n’est pas signé numériquement : si SmartScreen affiche « Windows a protégé votre ordinateur », cliquez sur Informations complémentaires, puis Exécuter quand même.
- Acceptez la demande d’élévation : l’application s’installe dans
C:\Program Files\HeelonVaultpour tous les utilisateurs du poste. - Lancez HeelonVault depuis le menu Démarrer. Le tout premier lancement peut prendre quelques secondes, le temps que Windows Defender analyse l’application.
-
Ouvrez le fichier
.dmget faites glisser HeelonVault dans le dossier Applications. -
L’application n’est pas signée par un compte développeur Apple, Gatekeeper la bloque donc au premier lancement :
- macOS 13 et 14 : clic droit (ou Ctrl+clic) sur HeelonVault dans Applications, choisir Ouvrir, puis confirmer Ouvrir ;
- macOS 15 et suivants : lancez l’application une première fois, fermez l’avertissement, puis ouvrez Réglages Système > Confidentialité et sécurité et cliquez sur Ouvrir quand même en face de HeelonVault.
Cette opération n’est nécessaire qu’une seule fois. Alternative en Terminal :
xattr -cr /Applications/HeelonVault.app.
Linux (AppImage)
Section intitulée « Linux (AppImage) »L’AppImage embarque GTK4 et libadwaita : rien d’autre à installer.
chmod +x heelonvault-linux-x86_64-vX.Y.Z.AppImage./heelonvault-linux-x86_64-vX.Y.Z.AppImageSi le lancement échoue avec une erreur mentionnant FUSE, installez la bibliothèque libfuse2
(Ubuntu 24.04 : sudo apt install libfuse2t64 ; Fedora : sudo dnf install fuse-libs).
Pour faire apparaître HeelonVault dans le menu des applications, rangez l’AppImage dans un
dossier stable (par exemple ~/Applications) et utilisez un outil d’intégration comme
Gear Lever ou AppImageLauncher.
Administrateurs : une installation système Linux (profil personnel ou entreprise, base partagée) est décrite dans UPDATE_GUIDE.md.
4. Premier lancement : créer votre compte
Section intitulée « 4. Premier lancement : créer votre compte »Au premier démarrage, un assistant crée le compte administrateur du coffre :
- Choisissez un identifiant et un mot de passe maître robuste. C’est le seul mot de passe à retenir : il ne peut pas être retrouvé par l’éditeur.
- Notez la phrase de récupération de 24 mots affichée. Elle permet de redéfinir le mot de passe maître si vous l’oubliez. Conservez-la hors de l’ordinateur (papier rangé en lieu sûr).
- Confirmez deux mots tirés au hasard pour prouver que la phrase a bien été notée.
- L’assistant se ferme et l’écran de connexion s’ouvre, identifiant pré-rempli : connectez-vous.
Sans mot de passe maître ni phrase de récupération, vos secrets sont irrécupérables. C’est le prix d’un chiffrement que personne d’autre que vous ne peut ouvrir.
5. Premiers pas
Section intitulée « 5. Premiers pas »- Créer un secret : bouton Ajouter en haut à droite, puis choisissez le type (mot de passe, clé API, clé SSH, document sécurisé…). Le bouton + de la barre latérale, lui, crée un nouveau coffre.
- Copier un mot de passe : sélectionnez la carte puis
Ctrl+C. Le presse-papiers est vidé automatiquement après 20 secondes ; l’icône de presse-papiers de la barre d’en-tête montre le compte à rebours, un clic l’efface immédiatement. - Sécuriser la session : dans Profil & Sécurité, activez la double authentification (TOTP), réglez le délai d’auto-verrouillage et, si vous le souhaitez, un code PIN de déverrouillage rapide.
- Importer vos mots de passe : Profil & Sécurité > Gestion des données > Importer des
données (CSV) accepte un export CSV (colonnes
name,url,username,password,notes).
Le guide utilisateur décrit chaque écran en détail.
6. Où sont mes données ?
Section intitulée « 6. Où sont mes données ? »Tout reste sur votre poste, dans une base SQLite chiffrée :
| Système | Base de données | Journaux |
|---|---|---|
| Windows | %LOCALAPPDATA%\Heelonys\HeelonVault\data\heelonvault\data\ |
%LOCALAPPDATA%\Heelonys\HeelonVault\data\heelonvault\logs\ |
| macOS | ~/Library/Application Support/fr.Heelonys.HeelonVault/heelonvault/data/ |
~/Library/Application Support/fr.Heelonys.HeelonVault/heelonvault/logs/ |
| Linux | ~/.local/share/heelonvault/ |
~/.local/state/heelonvault/logs/ |
Pour sauvegarder vos secrets, préférez l’export chiffré .hvb de Profil & Sécurité à une
copie brute du fichier de base.
7. Licence Professionnelle (optionnel)
Section intitulée « 7. Licence Professionnelle (optionnel) »Sans licence, HeelonVault fonctionne en édition Community, sans limite de durée ni de nombre de secrets. Une licence Professionnelle active en plus l’administration des utilisateurs, les équipes et coffres partagés, et les rapports d’audit signés : voir HeelonVault Premium.
Pour l’activer, copiez le fichier license.hvl fourni à cet emplacement, puis relancez
l’application :
| Système | Emplacement |
|---|---|
| Windows | C:\ProgramData\HeelonVault\license.hvl |
| macOS | ~/Library/Application Support/heelonvault/license.hvl |
| Linux | /etc/heelonvault/license.hvl (droits administrateur requis) |
Le badge « Licence free » de l’écran de connexion est remplacé par le sceau « Certifié par Heelonys » au nom de votre organisation. Un fichier invalide ou expiré est ignoré : l’application reste en édition Community.
8. Désinstaller
Section intitulée « 8. Désinstaller »- Windows : Paramètres > Applications > HeelonVault > Désinstaller.
- macOS : glissez HeelonVault depuis Applications vers la Corbeille.
- Linux : supprimez le fichier AppImage.
La désinstallation conserve vos données (voir section 6). Supprimez ce dossier à la main seulement si vous voulez effacer définitivement vos secrets, après en avoir fait un export si nécessaire.
Aller plus loin
Section intitulée « Aller plus loin »- Guide utilisateur — tous les écrans et fonctions
- Mettre à jour — passer à une nouvelle version
- Sécurité — modèle de menace, cryptographie, signalement de vulnérabilité
