deploymentking / kpcli

Alpine docker image to run readonly requests to kpcli

kpcli

Debian-based Docker image that runs a very simple shell script to simply execute readonly requests to the bundled kpcli package in order to extract password information from a KeePassX file. The file in question is determined by the environment variables passed to the Docker image.

Table of Contents

• Script Usage
  • Example

Script Usage

In order to extract passwords from a KeePassX file you will need four parameters:

• KPCLI_HOST_MOUNT: The local folder containing the KeePassX file that will be mounted to the Docker container's volume
• KPCLI_FILENAME: The name (and extension) of the KeePassX file
• KPCLI_PASSWORD: The KeePassX file's password
• KPCLI_ENTRY: The path inside the KeePassX database of the desired entry from which to extract the password

Example

# If your path has spaces don't forget to add double quotes around the string
KPCLI_HOST_MOUNT=/Users/$(whoami)/Downloads
KPCLI_FILENAME=NameOfKeePassXFile.kdbx
KPCLI_PASSWORD=supersecretpassword
KPCLI_ENTRY=/Root/Secret/Entry

docker run --net=none --rm -v ${KPCLI_HOST_MOUNT}:/keepassx -e FILENAME=${KPCLI_FILENAME} -e PASSWORD=${KPCLI_PASSWORD} -e ENTRY=${KPCLI_ENTRY} thinkstackio/kpcli:latest