Cryptomator CLI

This is a minimal command-line program that unlocks vaults of vault format 7. After the unlock the vault content can then be accessed via an embedded WebDAV server. The minium required Java version is JDK 11.

Disclaimer

This project is in an early stage and not ready for production use. We recommend to use it only for testing and evaluation purposes.

Download and Usage

Download the jar file via GitHub Releases.

Cryptomator CLI requires that at least JDK 11 is present on your system.

java -jar cryptomator-cli-x.y.z.jar \
    --vault demoVault=/path/to/vault --password demoVault=topSecret \
    --vault otherVault=/path/to/differentVault --passwordfile otherVault=/path/to/fileWithPassword \
    --bind 127.0.0.1 --port 8080
# you can now mount http://localhost:8080/demoVault/

Using as a docker image

Bridge networking with port forward:

⚠️ WARNING: This approach should only be used to test the containerized approach, not in production. ⚠️

The reason is that with port forwarding you need to listen on all interfaces, and potencially other devices on the network could also access your WebDAV server exposing your secret files.

Ideally you would run this in a private docker network with trusted containers built by yourself communicating with each other. Again, the below example is for testing purposes only to understand how the container would behave in production.

docker run --rm -p 8080:8080 \
    -v /path/to/vault:/vaults/vault \
    -v /path/to/differentVault:/vaults/differentVault \
    -v /path/to/fileWithPassword:/passwordFile \
    --bind 0.0.0.0 --port 8080 \
    cryptomator/cli \
    --vault demoVault=/vaults/vault --password demoVault=topSecret \
    --vault otherVault=/vaults/differentVault --passwordfile otherVault=/passwordFile
# you can now mount http://localhost:8080/demoVault/

Host networking:

docker run --rm --network=host \
    -v /path/to/vault:/vaults/vault \
    -v /path/to/differentVault:/vaults/differentVault \
    -v /path/to/fileWithPassword:/passwordFile \
    --bind 127.0.0.1 --port 8080 \
    cryptomator/cli \
    --vault demoVault=/vaults/vault --password demoVault=topSecret \
    --vault otherVault=/vaults/differentVault --passwordfile otherVault=/passwordFile
# you can now mount http://localhost:8080/demoVault/

Then you can access the vault using any WebDAV client.

Linux via davfs2

First, you need to create a mount point for your vault

sudo mkdir /media/your/mounted/folder

Then you can mount the vault

sudo mount -t davfs http://localhost:8080/demoVault/ /media/your/mounted/folder

To unmount the vault, run

sudo umount /media/your/mounted/folder

macOS via AppleScript

Mount the vault with

osascript -e 'mount volume "http://localhost:8080/demoVault/"'

Unmount the vault with

osascript -e 'tell application "Finder" to if "demoVault" exists then eject "demoVault"'

License

This project is dual-licensed under the AGPLv3 for FOSS projects as well as a commercial license derived from the LGPL for independent software vendors and resellers. If you want to use this library in applications, that are not licensed under the AGPL, feel free to contact our support team.

pmjohann/cli