antelle/keeweb repository overview

⁠Free cross-platform password manager compatible with KeePass

This webapp is a browser and desktop password manager compatible with KeePass databases. It doesn't require any server or additional resources. The app can run either in browser, or as a desktop app.

⁠Quick Links

Apps: Web⁠, Desktop⁠
Timeline: Release Notes⁠, TODO⁠
On one page: Features⁠, FAQ⁠
Website: keeweb.info⁠
Twitter: kee_web⁠
Donate: OpenCollective⁠, GitHub⁠

⁠Status

The app is quite stable now. Basic stuff, as well as more advanced operations, should be rather reliable.

⁠Self-hosting

Everything you need to host this app on your server is any static file server. The app is a single HTML file + a service worker (optionally; for offline access). You can download the latest distribution files from gh-pages⁠ branch.

If you are using Docker:

1. put your dh.pem, cert.pem, key.pem to /etc/nginx/external/
2. run this script:

docker run --name keeweb -d -p 443:443 -p 80:80 -v $EXT_DIR:/etc/nginx/external/ antelle/keeweb

To make Dropbox work in your self-hosted app, go to this Wiki page⁠.

⁠Building

The easiest way to clone all KeeWeb repos is:

curl https://raw.githubusercontent.com/keeweb/keeweb/develop/dev-env.sh | bash -

The app can be built with grunt: grunt (html file will be in dist/).
Desktop apps are built with grunt desktop. This works only in macOS as it builds dmg; requires wine.
Also, a hardware token is required.
To run Electron app without building an installer, build the app with grunt and start it this way:

grunt dev
npm run-script electron

For debug build:

1. run grunt dev
2. open http://localhost:8085

⁠Contributing

Please read contribution guidelines for pull requests⁠.
Here's a list of issues⁠ where your help would be very welcome. Also you can help by translating KeeWeb⁠ to your language.

⁠Important notes for pull requests

• please branch from develop, not master
• don't edit translation files except base.json, they will be replaced

⁠Donations

KeeWeb is not free to develop. It takes time, requires paid code signing certificates and domains.
You can help the project or say "thank you" with this button:

You can also sponsor the developer directly on GitHub⁠.

Please note: donation does not imply any type of service contract.

⁠License

MIT⁠