keeweb/README.md

4.1 KiB

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.

screenshot

Tested on BrowserStack

Quick Links

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

Status

Project roadmap with planned features and approximate schedule is on TODO page.

Self-hosting

Everything you need to host this app on your server is any static file server. The app is a single HTML file + cache manifest (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:

  1. create a Dropbox app
  2. find your app key (in Dropbox App page, go to Settings/App key)
  3. add your Dropbox app key to settings json

Building

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 mac osx as it builds dmg; requires wine.
To run Electron app without building installer, install electron package (npm install electron -g), build the app with grunt and start in this way:

$ grunt dev
$ npm run-script electron

For debug build:

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

Contributing

Please, read contribution guidelines: for issues and for pull requests.
For pull requests: branch is important! master is only for hotfixes, develop is for new features.
Here's a list of issues which heed help. Also you can help by translating KeeWeb to your language.

Donations

Donate with PayPal:
Donate with PayPal

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

License

MIT