Sanitizer: How to Use


#1

Sanitizer is a tool which can detect problems in Cryptomator vaults and restore lost data.

Currently, Sanitizer is only available as a console application. We will integrate it into Cryptomator soon. For now, the following instructions tell you how to use Sanitizer.

Java Installation

At first, you need to have Java 9 or newer.

  • Java for Windows is available for download here.
  • JDK for macOS can be obtained here.
  • There are various ways to install it on Linux, it vastly depends on your distribution.

To verify you meet the minimum required Java version, you can simply invoke the following command via your command line interpreter:

java -version

Running Sanitizer

Now you need to download the Sanitizer jar file. Afterwards you can run Sanitzer.

To do that on Windows, open the command prompt (Start Menu > Enter “cmd” and press enter) and enter the following command:

java -jar C:\path\to\sanitizer-0.15.jar check -vault C:\path\to\vault -deep

Replace the paths C:\path\to\sanitizer-0.15.jar and C:\path\to\vault accordingly. You can open an Explorer window and drag and drop the JAR file and vault directory into the command prompt to insert the correct path.

This video shows how to do that on macOS.

After running Sanitizer, the files *.structure.txt and *.check.txt are created. Those files contain some information about your vault (a list of the (encrypted) files and a problems report). If your vault does not work as expected, you can send the files to our support email address and we will have a look.

Advanced Usage

If you’re looking for a way to restore missing file extensions after using the decryptVault command, please read this guide: Sanitizer: Restore Missing File Extensions


Sanitizer: Restore Missing File Extensions
File corruption (KeePass document)
Going crazy with crypto
Tresor entsperrt - Dateien nicht möglich zu öffnen oder kopieren
Encrypted files are not synchronized correctly
decrypt the encrypted file name
Some files not readable on High Sierra, but works fine in the iOS app
Some files not readable on High Sierra, but works fine in the iOS app
Videos are broken after encryption
#2

Java 9 issue:
The current default install (at least for Windows 10 64 bit) seems to be 1.8.0_191 (that is JavaSE8)
The next higher I can find is Java SE 11 - but only the JDK, no JRE.
https://www.oracle.com/technetwork/java/javase/downloads/index.html

How to make Sanitizer run…?


#3

You can use any higher JRE or JDK. I.e. JDK11 is fine.


#4

Thanks for the quick reply.
There seems to be no installer for Java >8 and the manual install of the currently downloadable SE11 seems to require some effort and expertise.
I found an installer for Java SE 10 on our intranet via our comporate softwarecenter and the Sanitizer now works for me.
If somone can point to a public downloadable executable installer for Java 9 or higher, that would be helpful for others while Oracle is stll pointing to Java 8 as the default.