Open and edit a KeePass vault in your browser.
Open the app · Try the demo · Download
The current interface is the default for the app, demo, downloads and development server. Classic is deprecated and retained for compatibility. Both interfaces use the same vault, encryption and synchronization implementations. KeeWebX is a web-only fork of KeeWeb, built with TypeScript, Preact and Bun.
Download the recommended keewebx-new-<version>.zip or .tar.gz from Releases, verify its accompanying SHA-256 checksum, and extract the complete archive.
| Package | Homepage | Other entry points |
|---|---|---|
keewebx-new-<version> (recommended) |
New | next.html |
keewebx-classic-<version> (deprecated) |
Classic | classic.html, classic/index.html |
keewebx-web-<version> (combined compatibility bundle) |
New | Both interfaces and in-app switching |
Each package includes its own assets and offline service worker. Standalone packages hide switching to the other interface. The combined bundle keeps ?ui=classic compatibility routes.
Double-click index.html, or serve the extracted directory with any static HTTP server:
python3 -m http.server 8080Keep the HTML files and bundled assets together. HTTPS or localhost enables features that require a secure context; passkeys also depend on browser and authenticator support. Direct file:// use does not register a service worker or check an update server. Local HTML blocks communication with keewebx.app and its subdomains. Your configured WebDAV synchronization and other external services remain available. Website icons are downloaded directly instead of through an app server. Download a newer release separately to update.
KDBX encryption and decryption run in your browser. A browser-cache save does not update the external file you originally selected: download KDBX to save an external copy. Keep an independent encrypted backup. WebDAV synchronization and optional network features make requests only when configured or used, including in local HTML.
See the self-host guide for deployment details.
- Open local KDBX files, use password and key-file combinations, configure supported passkeys, and work with multiple vaults.
- Edit entries, protected and multiline fields, groups, tags, expiry dates, icons and templates. Inspect and restore history; preview and manage attachments.
- Search selected fields, protected values and history with explicit options; use keyboard shortcuts, sorting, color filters and mobile navigation.
- Generate passwords, manage OTP credentials, review password warnings, and import or export supported formats.
- Save to WebDAV, see per-vault synchronization state, recover from offline or failed saves, and explicitly save or discard when closing a vault.
- Use browser autofill with KeeWebX Connect, with explicit access approval and session controls.
Use the sidebar’s database menu to save or close a vault. The key icon in the bottom toolbar opens the password generator. Entry details keep Edit and More actions together; copy, reveal and website actions stay beside their fields. Use a group’s ⋯ menu to manage it, and click an entry’s icon or choose Change icon and color from More to set a color flag. On a phone, the panel button opens the same navigation and tools.
Switching interfaces checks pending edits and saves before navigating. A failed save keeps the vault available for recovery.
The current web interface keeps one main App per site and browser storage partition. Opening it again shows KeeWebX is already open with Close this tab as the main action and Try switching to KeeWebX as an alternative. A fresh duplicate opened by another page attempts to close automatically. If the browser keeps it open, the page explains how to close it manually. The original App keeps its vault; the duplicate does not start another database session. A visible waiting page can continue after the main App closes. See single-instance behavior and limits.
On startup, the web App checks for updates before showing the unlock screen. A ready update is applied first. The check waits at most 2.5 seconds so offline or slow connections can still open the App. Updates discovered during an active session wait silently until the next startup; no update notice interrupts an unlocked vault.
KeeWebX Connect releases provide browser autofill. Choose the app location in the extension, open and unlock a vault, then approve the connection in KeeWebX. Access can be limited to selected vaults and revoked from the app's extension settings.
For Chrome, Edge and Firefox, follow the extension setup guide. Use https://keewebx.app/app for the hosted app; replace old /preview/ addresses. Setup and troubleshooting are also available in the extension's options, including before a connection succeeds.
For iOS Safari with Userscripts, install the experimental KeeWebX Connect userscript and authorize your unlocked app once. The key appears beside recognized login fields. Tap it and select a matching account, or enable the optional single-match fill setting. A temporary connection page finds the original app and closes itself after port handoff; the website verifies the App signature before using it, and subsequent requests use a direct MessagePort. Switching websites reuses the same authorization through the encrypted Connect protocol. Keep the app open and visit it if needed. Native iOS and standalone PWA acceptance remain unverified.
git clone https://github.com/gynet/keewebx.git
cd keewebx
bun install
bun run test
bun run buildThe build writes both interfaces into dist/. Serve that directory to open the current interface by default. bun run dev starts the current interface at http://localhost:8085; bun run dev:classic explicitly starts the deprecated Classic development server.
| Package | Purpose |
|---|---|
modules/ui |
New interface, built with Preact |
modules/ui-classic |
Deprecated Classic compatibility interface |
modules/ui-kit |
Shared presentation helpers |
modules/vault |
Vault models, storage, synchronization and application services |
modules/db |
KDBX database library |
modules/extension |
Browser autofill extension |
Shared vault code does not import either interface. Browser acceptance covers New and Classic in Chromium and Firefox; individual tests identify browser-specific capability limits.
MIT. Built on KeeWeb by Antelle and kdbxweb. See third-party notices for bundled dependencies.

