HeelonVault 2.1.1
HeelonVault is a local-first desktop secrets manager: passwords, API keys, SSH keys and sensitive documents are encrypted and stored on your computer, with no server and no online account. Written in Rust, with a GTK4 / libadwaita interface, for Windows, macOS and Linux.
Distributed under the Apache 2.0 License. See LICENSE for software terms and LEGAL.md for trademark and Authenticity Seal terms.
Full documentation: doc.heelonvault.heelonys.fr
Installation
Section titled “Installation”Download the package for your system from the Releases page:
| System | Package |
|---|---|
| Windows 10 / 11 (x64) | heelonvault-windows-x86_64-vX.Y.Z.msi |
| macOS 13+ (Apple Silicon) | heelonvault-macos-aarch64-vX.Y.Z.dmg |
| Linux (x86_64) | heelonvault-linux-x86_64-vX.Y.Z.AppImage |
Verification, step-by-step install and first launch: Installation and quickstart.
Core Features
Section titled “Core Features”| Area | Details |
|---|---|
| Encryption | Application-level AES-256-GCM — secrets never leave the machine in plaintext |
| Authentication | Argon2id key derivation (GPU-resistant) + TOTP two-factor authentication (RFC 6238) |
| First launch | Guided wizard creating the administrator account, followed by an explicit sign-in |
| Recovery key | 24-word phrase generated at setup; sets a new master password without losing any vault; re-exportable from the profile |
| Vaults | Several vaults per account; search the active vault or all of them (MultiVault) |
| Display | Cards or compact list, usage-based ordering, badges (strength, duplicate, incomplete, health, shared) |
| Clipboard | Password decrypted only at copy time, automatic clearing (20 s, 60 s for the recovery phrase), exposure indicator in the header bar |
| Search | Title, login, email, URL, notes, category, tags, type; field:value syntax, Unicode normalization, #sante shortcut |
| Keyboard | On the active card: Ctrl+C (password), Ctrl+L (login), Ctrl+U (open URL) |
| Session | Auto-lock (1 to 30 minutes or never), quick-unlock PIN, brute-force protection |
| Import / Export | Guided 3-step CSV import, error-tolerant; encrypted .hvb export |
| Trash | Soft delete with restore and permanent purge |
| Strength meter | Real-time zxcvbn evaluation of every password |
| Security center | Local cross-vault diagnostics: weak/reused passwords, expiration, links to review, explicit analysis coverage and guided correction |
| URL checks | Immediate local checks; optional DNS/TLS handshake with consent for each check. No page loading or reputation lookup |
| Health marker | “Health data access” field to single out secrets tied to medical data |
| Logging | Daily-rotated JSON logs, free of any secret value |
| Pro license | User administration, teams and shared vaults, signed audit reports (Ed25519); without a license, full Community edition |
Audit and Compliance
Section titled “Audit and Compliance”HeelonVault follows a security-first approach for GDPR-oriented data protection.
License and transparency
Section titled “License and transparency”- Dependency inventory: complete third-party component list and licenses are documented in THIRD_PARTY_LICENSES.md.
- Signed CycloneDX SBOM: with every version, the SBOM of the shipped binary (core + app + premium) is published on the GitHub release (
heelonvault-sbom-<version>.cyclonedx.json+.sha256), with a Sigstore build-provenance attestation verifiable viagh attestation verify heelonvault-sbom-<version>.cyclonedx.json --repo ppaperso/heelonvault-core. - Auditable proprietary component:
heelonvault-premium(licensing, administration, teams, audit report) is proprietary and its source is not public. A customer’s security teams (IT department, CISO, appointed auditor) can be given read access for audit, under a non-disclosure agreement (NDA): see SECURITY.md. - No statically linked copyleft dependency — the only LGPL libraries (GTK4, libadwaita) are dynamically linked.
Cryptographic primitives
Section titled “Cryptographic primitives”- AES-256-GCM for authenticated encryption (
aes-gcmcrate, RustCrypto). - Argon2id for deriving keys from the master password.
- HMAC-SHA1 / SHA256 for TOTP generation (
totp-rs). - CSPRNG via
getrandom(kernel RNG) for salts, nonces and keys.
Code policy
Section titled “Code policy”clippy.toml bans unwrap() / expect() on Result and Option, and the workspace rejects any
unsafe block and any compiler warning: an unexpected panic cannot expose sensitive data in an
error message.
Vulnerability reporting
Section titled “Vulnerability reporting”See SECURITY.md.
Development
Section titled “Development”heelonvault-core/├── crates/│ ├── heelonvault-core/ # Public library (crates.io)│ ├── heelonvault-app/ # GTK4 / libadwaita binary (migrations, assets, MSI installer)│ └── sqlx-shim/ # Local SQLx shim├── linux/ macos/ # AppImage launcher and macOS bundle files├── scripts/ # Dev launcher, Linux system install, SBOM└── docs/ # Documentation (docs/internal/: maintainers)./scripts/run-dev.sh # dev database: data/heelonvault-rust-dev.dbcargo test --workspacePrerequisites, quality gates and builds: development guide. Contribution rules: CONTRIBUTING.md.
Premium:
heelonvault-premiumis a proprietary component kept in a separate private repository, checked out next to this one to build the binary.
Documentation
Section titled “Documentation”| Document | English | French |
|---|---|---|
| Installation and quickstart | QUICKSTART.md | QUICKSTART.fr.md |
| User guide | USER_GUIDE.en.md | USER_GUIDE.md |
| Updating and deployment | UPDATE_GUIDE.en.md | UPDATE_GUIDE.md |
| Security | SECURITY.md | SECURITY.fr.md |
| Architecture | ARCHITECTURE.en.md | ARCHITECTURE.md |
| Changelog | CHANGELOG.en.md | CHANGELOG.md |
| Third-party licenses | THIRD_PARTY_LICENSES.md | THIRD_PARTY_LICENSES.fr.md |
| Contributing | CONTRIBUTING.md | CONTRIBUTING.fr.md |
| Code of Conduct | CODE_OF_CONDUCT.en.md | CODE_OF_CONDUCT.md |
| Internal documentation (maintainers) | docs/internal/ |
Source version: 2.1.1 (in preparation) — detailed notes in CHANGELOG.en.md. Published packages remain available on the Releases page.
