Cryptomator

Cryptomator

Support for client-side encryption with Cryptomator interoperable vaults to secure your data on any server or cloud storage.

Browse Cryptomator Vault

The client-side encryption feature in Cyberduck and Mountain Duck is based on the excellent concepts and work of Cryptomator. Cryptomator is free and open-source software. Since Cyberduck is also open-source software anyone is able to audit the source code. That means no security by obscurity, no hidden backdoors from third parties, no need to trust anyone except yourself.

Tip

Compared to other client-side-encryption solutions, the Cryptomator based approach yields a few crucial advantages:

  • In addition to file content encryption, file and directory names are encrypted and directory structures obfuscated.

  • No online services, no subscriptions, no accounts.

  • No need to share your cloud storage provider credentials.

Create new Vault

You can create a new vault directory anywhere on your remote storage. This will initialize the vault with a masterkey.cryptomator. A backup of the master key file (masterkey.cryptomator) is saved in user defaults. The encrypted keys in masterkey.cryptomator are not more sensitive than the encrypted files in the vault. For technical aspects, refer to Masterkey Derivation.

Choose File → New Vault… to create a new vault.

New Encrypted Vault File Menu Option

Unlock Vault

Discovery

When Preferences → Cryptomator → Auto detect and open vault in browser is enabled, opening a directory in the browser that is a Cryptomator Vault, a prompt is displayed to unlock the vault using the provided passphrase and decrypt the directory and filenames. If you cancel the prompt, the encrypted vault content is displayed.

Note

A vault is only detected if masterkey.cryptomator or vault.cryptomator are found as one of the 10 files of the directory listing retrieved from the server.

Mountain Duck Unlock Vault

Manual

Choose the Cryptomator button in the toolbar or File → Unlock Vault and File →Lock Vault menu to unlock or lock a vault respectively.

Attention

The menu option is disabled if you have set Preferences → Cryptomator → Auto detect and open vault in browser

Save Passphrase

You can check Save Password to save the passphrase to open the vault with the master key file in your login keychain. The checkbox is disabled by default.

Manage your passwords with Keychain Access.app on Mac. Refer to the Keychain Access User Guide. Another application that wants to access the vault passphrase from the login keychain will trigger a permission prompt.

Keychain Access Cryptomator Passphrase

File Transfers

File transfers require you to unlock the vault again unless you have chosen to save your vault passphrase in the keychain.

Renaming

When renaming a vault the behaviour depends on whether the vault is locked or unlocked:

  • Renaming a locked vault will rename the vault folder with no changes to the encrypted contents.

  • Renaming an unlocked vault changes it to regular folder with decrypted contents.

Browser

You can open and browse multiple vaults on a server in a single browser window. For each vault to be opened you will be prompted to enter your passphrase to decrypt the filenames. Decrypted filenames when browsing a vault will show a padlock overlay icon.

Cryptomator Vault Browser

Moving Files Into Vault

You can move files from and to the vault. Because files need to be encrypted or decrypted respectively they pass through your local computer and cannot be moved on the server-side.

Attention

The vault must be unlocked before you move files to it, otherwise the files won’t be encrypted.

Access Vaults on Local Disk

Both Cyberduck and Mountain Duck support browsing your local disk to access vaults created on your computer. Refer to the tutorial.

Known Limitations

  • As name shortening is not supported, the maximum length for a filename (including extension) is 146 characters. Note that using non-ASCII characters in your filenames may lower this limit.

  • Changing the vault passphrase is currently not supported.

  • To delete a vault it cannot be unlocked. Choose Cancel in the vault password prompt to skip unlocking the vault after selecting the vault folder for delete.

  • Creating or accessing a vault within a vault is currently not supported using Cyberduck.

  • Locking or unlocking a vault requires network connectivity using Mountain Duck regardless of the connect mode.

Preferences

Auto Detect

Uncheck Preferences → Cryptomator → Auto detect and open Vault in browser to disable opening vaults by default when opening the vault directory in the browser.

Use Keychain

Save the password in Keychain or Credential Manager to unlock vaults automatically upon connecting.

Note

Without saving the vaults passwords using keychain, you will receive passwords prompts for the vaults after reconnecting to the server or cloud storage.

References

See Encryption Security Architecture.