Skip to content
downlevelPublic

About

Open source KeePass-compatible password manager for Linux, Windows and macOS, written in Rust and Tauri. KDBX 4, offline, no cloud

Topics

Resources

Contributing

Security policy

Accessibility

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Keyrust

CI

A calm, minimal KeePass client for the desktop, written in Rust.

Keyrust is an open source password manager for Linux, Windows and macOS. It reads and writes the standard KDBX format, so your database stays a plain file you own: open it with KeePassXC, KeePassDX (Android) or Strongbox (iOS), and sync it with Syncthing, Nextcloud or Dropbox. No account, no cloud, no telemetry, no network access.

Status: alpha, not audited. Keyrust opens and saves real databases and is tested against KeePassXC in CI, but it is young software. Keep backups of your database.

Download for Windows, macOS and Linux · Verify the download · Build from source

The Keyrust vault: groups, entries and the details of an entry

Unlock screen with recent databases Entry editor with the password generator Settings: clipboard, auto-lock and generator

The screenshots show the built-in demo data.

Features

  • Create, open and save KDBX databases protected by a master password. New databases use KDBX 4 with Argon2id, calibrated to about one second on your computer.
  • Groups (nested) and entries with title, username, password, URL and notes; entry history; a recycle bin with restore.
  • Instant search over titles, usernames and URLs (never passwords).
  • Password generator using the system's secure random source, with a strength estimate.
  • Copy to the clipboard from the Rust process, cleared automatically after a delay, on lock and on exit.
  • Auto-lock on inactivity, when the screen locks, when the computer sleeps, and optionally when the window is minimized.
  • Safe saving: atomic writes, and detection of changes made by another app before saving (Reload or Keep mine). A write that lands in the instant between the last check and the save cannot be detected (details).
  • Database settings: name, cipher, key-derivation parameters, recycle bin, master password.
  • Everything works from the keyboard, with a command palette (Ctrl+K) and a shortcuts panel.
  • Accessibility checked in CI: WCAG 2.1 AA contrast, visible focus, screen-reader roles and announcements, reduced motion (details).

Not in this version

Auto-type, browser integration, keyfiles, hardware keys, TOTP codes, import from other password managers, attachments in the UI (existing attachments are preserved), a dark theme, and merging sync conflicts. Some are planned (roadmap); auto-type, a browser extension and a sync server of our own are not (product requirements).

Security in one minute

  • The file is encrypted and authenticated (KDBX4). Its safety rests on your master password.
  • Key-derivation parameters are checked before the key is derived, so a file tampered with by a sync provider cannot freeze your computer.
  • Passwords are not in the entry list, the details or search results, and copying happens in Rust. The webview sees a password only while you edit, reveal or generate it.
  • The vault locks itself, from the Rust process, even if the UI hangs.
  • Memory-safe Rust, unsafe confined to a few operating-system calls, no hand-written cryptography, audited dependencies, fuzzing of the file parser.
  • Not protected: malware on an unlocked computer, a weak master password, a sync provider deleting or rolling back your file.

The full threat model is in SECURITY.md.

Architecture

flowchart LR
    subgraph rust["Keyrust process (Rust)"]
        core["crates/core<br/>vault, KDBX, crypto"]
        app["crates/app<br/>Tauri shell, IPC commands,<br/>clipboard, auto-lock"]
        os["crates/os<br/>screen lock, sleep"]
    end
    ui["Webview<br/>crates/app/ui (Svelte)"]
    file[("KDBX file")]
    clip["Clipboard"]
    sys["Operating system"]
    ui <-->|IPC| app
    app --> core
    app --> os
    core <--> file
    app --> clip
    os <--> sys
Loading

crates/core is the vault and the file format, with no UI dependency, built on keepass-rs and RustCrypto. crates/app is the Tauri 2 desktop shell: the only way the UI reaches the vault is a fixed list of IPC commands. crates/os detects screen lock and sleep, and is the only crate with unsafe code. Details are in docs/ARCHITECTURE.md.

Compatibility

  • KeePassXC: tested automatically both ways in CI on Linux, Windows and macOS. Keyrust opens files made by KeePassXC and saves them without losing custom fields, attachments, history or anything it does not display, and KeePassXC reads every file Keyrust writes.
  • KeePassDX and Strongbox: use the same format, but have not been verified by hand yet.
  • KDBX 3.1 and 4.0: open normally; the first save converts the file to KDBX 4.1, and Keyrust tells you so when you open it. Very old clients that only read KDBX 3.1 cannot open the converted file.

Keyrust and KeePassXC

KeePassXC is mature and full-featured, and Keyrust uses it as the reference for compatibility. The comparison below is as of KeePassXC 2.7.

KeePassXC 2.7 Keyrust 0.1
KDBX 4 format ✅ ✅
Auto-type ✅ ❌
Browser integration ✅ ❌
Keyfiles, YubiKey ✅ ❌
TOTP codes ✅ ❌
Import (CSV, 1Password, Bitwarden…) ✅ ❌
KeeShare, SSH agent ✅ ❌
Interface Feature-rich Minimal, three columns, keyboard-first
Language C++ Rust (memory-safe)
Where passwords are held One C++ / Qt process The Rust process; the UI webview only while you edit, reveal or generate one
Compatibility with KeePassXC — Verified in CI against keepassxc-cli

If you need any of the features Keyrust lacks, KeePassXC is the right choice, and your database works in both.

Download

Installers are on the Releases page:

System File
Windows 10 and 11 Keyrust_X.Y.Z_x64-setup.exe (or the .msi, for managed deployment)
macOS, Intel and Apple Silicon Keyrust_X.Y.Z_universal.dmg
Debian, Ubuntu and derivatives Keyrust_X.Y.Z_amd64.deb
Other Linux distributions (x86-64) Keyrust_X.Y.Z_amd64.AppImage

Check your download as described in Verifying releases.

The installers are not code-signed for Windows or macOS yet (the release notes say when they are). Windows SmartScreen shows Windows protected your PC: choose More info → Run anyway. macOS refuses to open the app the first time: open System Settings → Privacy & Security and choose Open Anyway. Some corporate computers do not allow unsigned software at all; there, build from source (below) or ask your administrator.

Building

Prerequisites for each OS are in docs/DEVELOPMENT.md. In short:

cd crates/app/ui
pnpm install
pnpm tauri dev            # run the desktop app
pnpm tauri build          # build an installer for this OS

pnpm dev alone runs the UI in a browser on demo data (password secret).

Testing

cargo test -p keyrust-core          # core; KeePassXC compatibility needs keepassxc-cli
cd crates/app/ui
pnpm test                           # UI unit and component tests (Vitest)
pnpm test:web                       # accessibility audit in Chromium (Playwright + axe)

The end-to-end test of the real app (crates/app/e2e, WebdriverIO and tauri-driver) runs in CI on Linux. See docs/DEVELOPMENT.md.

Documentation

License

Copyright © 2026 Mauro Giulivi. Licensed under the GNU General Public License v3.0 or later.

About

Open source KeePass-compatible password manager for Linux, Windows and macOS, written in Rust and Tauri. KDBX 4, offline, no cloud

Topics

Resources

Contributing

Security policy

Accessibility

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages