Table of Contents
Command-line switches
In order to control some features of desktop app, you can use the following command-line switches:
--proxy-server=1.2.3.4:80
use proxy 1.2.3.4:80 instead of system-wide setting
--minimized
start the app minimized to tray or menubar
--devtools
show devtools on start
--startup-logging
print startup debugging messages to stdout
You can also specify a file you would like to open as the last argument:
KeeWeb my.kdbx
Or with a keyfile:
KeeWeb --keyfile=keyfile.key my.kdbx
JSON app config
The webapp can load settings from JSON config located on your server. There are two options to specify config location, whichever you like more:
- add
config
url parameter:https://your-keeweb-deployment-url/?config=your-config.json
- set
kw-config
meta-tag value: replace(no-config)
string in app index.html with your config url (please remember to clear browser cache to make sure changes are applied)
Config fields description (all fields are optional; please don't copy exactly this config; add only necessary fields and remove all comments):
{
"settings": {
...
},
"files": [{ // pre-defined files that will appear on Open page
"storage": "webdav", // dropbox, webdav, other cloud storage providers
"name": "My file", // file name, as it will be displayed in UI
"path": "webdav-url", // full path to file, including file name, e.g. WebDAV url
"options": { "user": "", "password": "" } // only for WebDAV, server auth details
}],
"showOnlyFilesFromConfig": false, // allow to open only files from config, remove previously opened files
"plugins": [{ // if you want to auto-install some plugins
"url": "" // plugin url (you can also add "manifest" to enforce publicKey validation)
}]
}
Settings configuration options can be found here.
To get currently applied settings, run this in browser console:
kw.settings.get();
If it doesn't start with your config:
- open DevTools in browser and inspect the error
- validate your config, e.g. here: https://jsonlint.com/
App settings js API
There's an interface for accessing app settings from this list:
var value = kw.settings.get('setting');
var allSettings = kw.settings.get();
kw.settings.set('setting', value);
kw.settings.set({ setting: value });
kw.settings.del('setting');
Values you set here are saved and applied immediately. Please be careful.
You can call these methods from dev console.
Portable
By default KeeWeb saves temporary files and configs into the default user's data directory. To create a completely portable installation:
- put KeeWeb to the desired location, for example a USB drive
- create a file called
keeweb-portable.json
with the following content:
(if you're on Windows, don't forget to escape slashes in JSON, like{ "userDataDir": "relative/path/to/data/dir" }
"C:\\program files\\..."
).
The config should be located:- on windows: next to
KeeWeb.exe
- on Linux: next to
KeeWeb
(executable) - on macOS: next to
KeeWeb.app
- on windows: next to
- launch KeeWeb and make sure it creates the directory you specified in the config
Getting started
FAQ
Supported Platforms
iOS
Auto Type
Browser AutoFill
YubiKey
Contributing
About KeeWeb
Self-hosting and configuration
Configuration
WebDAV Config
Dropbox and GDrive
Developing and extending KeeWeb
The only official web app is https://app.keeweb.info