Run KeePass in Docker and use REST or MCP to create KDBX vaults, tune Argon2, manage entries, and...
677
Put KeePass behind REST and MCP. Create a vault, rotate its master password, turn Argon2 up to 512 MiB, or grab a TOTP code from the terminal. You can open the same .kdbx in KeePassXC.
Run this as your regular Docker user on Linux. You need Docker Compose, curl, and OpenSSL.
curl -fsSL https://raw.githubusercontent.com/psyb0t/docker-keepassbox/main/install.sh | bash
keepassbox start
If your shell can't find the command, run ~/.local/bin/keepassbox start. Run keepassbox token to get the installer-generated bearer token. It can manage its owner's vaults, read passwords, and generate TOTP codes. REST is at http://localhost:8000/v1, and MCP is at http://localhost:8000/mcp.
The installer puts the Compose files and vaults in ~/.config/keepassbox/ by default and uses the published psyb0t/keepassbox:latest image. See the install guide to pin a version, change the port, or upgrade.
Ordinary edits preserve entry history. The API reference lists the supported operations and file formats.
Connect a Streamable HTTP MCP client to http://localhost:8000/mcp and configure its bearer token. See MCP configuration.
openclaw skills install @psyb0t/docker-keepassbox
openclaw plugins install clawhub:@psyb0t/keepassbox
Configure KEEPASSBOX_URL and KEEPASSBOX_TOKEN for the OpenClaw bridge.
Read the KeePassBox docs for install options, vault security settings, and the REST and MCP commands.
make lint
make test
make sec
make build
The tests run in Docker with synthetic KDBX files. The engine tests check encrypted round trips and TOTP. Integration tests call both transports.
GPL-3.0. The vault engine uses PyKeePass.
Content type
Image
Digest
sha256:2bb363505…
Size
64.3 MB
Last updated
24 minutes ago
docker pull psyb0t/keepassbox