Skip to content
gynetPublic

About

KeePass in your browser. No install, no signup, works offline. KDBX4, passkey unlock, browser extension autofill, and it runs from a double-clicked .html file. Try the demo: keewebx.app/demo

Topics

Resources

Stars

46 stars

Watchers

2 watching

Forks

Repository files navigation

KeeWebX

Open and edit a KeePass vault in your browser.

Try the demo Latest release License: MIT

Open the app · Try the demo · Download

KeeWebX New interface with the demo vault open on desktop   KeeWebX New interface showing the same demo entry on a phone

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.

Use it locally

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 8080

Keep 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.

New interface

  • 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.

Browser extension

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.

Development

git clone https://github.com/gynet/keewebx.git
cd keewebx
bun install
bun run test
bun run build

The 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.

License and credits

MIT. Built on KeeWeb by Antelle and kdbxweb. See third-party notices for bundled dependencies.

About

KeePass in your browser. No install, no signup, works offline. KDBX4, passkey unlock, browser extension autofill, and it runs from a double-clicked .html file. Try the demo: keewebx.app/demo

Topics

Resources

Stars

46 stars

Watchers

2 watching

Forks

Releases

Packages

Used by

Contributors

Languages