Skip to content
Back to search

docker-keepassbox

Run KeePass in Docker and use REST or MCP to create KDBX vaults, tune Argon2, manage entries, and grab TOTP codes.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/psyb0t--docker-keepassbox/badge.svg)](/listings/psyb0t--docker-keepassbox)

HTML

<a href="/listings/psyb0t--docker-keepassbox"><img src="/api/listings/psyb0t--docker-keepassbox/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

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](https://psyb0t.github.io/docker-keepassbox/install/) to pin a version, change the port, or upgrade.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 77 lines · 1 finding marked
  1. # KeePassBox
  2. [![CI](https://github.com/psyb0t/docker-keepassbox/actions/workflows/pipeline.yml/badge.svg?branch=main)](https://github.com/psyb0t/docker-keepassbox/actions/workflows/pipeline.yml)
  3. [![version](https://raw.githubusercontent.com/psyb0t/docker-keepassbox/badges/version.svg)](https://github.com/psyb0t/docker-keepassbox/releases)
  4. [![license](https://raw.githubusercontent.com/psyb0t/docker-keepassbox/badges/license.svg)](LICENSE)
  5. [![Docker Pulls](https://img.shields.io/docker/pulls/psyb0t/keepassbox?style=flat-square)](https://hub.docker.com/r/psyb0t/keepassbox)
  6. 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.
  7. ## Contents
  8. - [Quick start](#quick-start)
  9. - [What it does](#what-it-does)
  10. - [Agent integrations](#agent-integrations)
  11. - [Documentation](#documentation)
  12. - [Development](#development)
  13. - [Sponsor](#sponsor)
  14. - [License](#license)
  15. ## Quick start
  16. Run this as your regular Docker user on Linux. You need Docker Compose, curl, and OpenSSL.
  17. ```sh
  18. curl -fsSL https://raw.githubusercontent.com/psyb0t/docker-keepassbox/main/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 25 on GitHub
  19. keepassbox start
  20. ```
  21. 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`.
  22. 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](https://psyb0t.github.io/docker-keepassbox/install/) to pin a version, change the port, or upgrade.
  23. ## What it does
  24. - Create and unlock multiple vaults with a master password, a configured key file, or both.
  25. - Change the KDBX 4 cipher, KDF, Argon2 memory, iterations, parallelism, and compression. Rotate the password or key file separately.
  26. - Create groups, search entries, move or trash them, and edit passwords, notes, tags, protected fields, and small attachments.
  27. - Save a TOTP seed or URI inside an entry and return the current code and expiry.
  28. - Give each bearer token access to one owner's vaults. Restrict individual tokens with a custom [scope list](https://psyb0t.github.io/docker-keepassbox/api/#access).
  29. Ordinary edits preserve entry history. The [API reference](https://psyb0t.github.io/docker-keepassbox/api/) lists the supported operations and file formats.
  30. ## Agent integrations
  31. Connect a Streamable HTTP MCP client to `http://localhost:8000/mcp` and configure its bearer token. See [MCP configuration](https://psyb0t.github.io/docker-keepassbox/mcp/).
  32. ```sh
  33. openclaw skills install @psyb0t/docker-keepassbox
  34. openclaw plugins install clawhub:@psyb0t/keepassbox
  35. ```
  36. Configure `KEEPASSBOX_URL` and `KEEPASSBOX_TOKEN` for the OpenClaw bridge.
  37. ## Documentation
  38. Read the [KeePassBox docs](https://psyb0t.github.io/docker-keepassbox/) for install options, vault security settings, and the REST and MCP commands.
  39. ## Development
  40. ```sh
  41. make lint
  42. make test
  43. make sec
  44. make build
  45. ```
  46. The tests run in Docker with synthetic KDBX files. The engine tests check encrypted round trips and TOTP. Integration tests call both transports.
  47. ## Sponsor
  48. [Sponsor on GitHub](https://github.com/sponsors/psyb0t)
  49. <a href="https://www.buymeacoffee.com/psyb0t"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-blue.png" alt="Buy Me a Coffee" height="60" width="217"></a>
  50. ## License
  51. [GPL-3.0](LICENSE). The vault engine uses [PyKeePass](https://github.com/libkeepass/pykeepass).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.