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. Eventually, we will integrate it into Cryptomator. For now, follow the instructions on how to use Sanitizer.

Java Installation

At first, you need to have Java 9 or newer. The latest version of Java can be found here.

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
Encrypted files are not synchronized correctly
Tresor entsperrt - Dateien nicht möglich zu öffnen oder kopieren
decrypt the encrypted file name
Some files not readable on High Sierra, but works fine in the iOS app
Videos are broken after encryption
Some files not readable on High Sierra, but works fine in the iOS app
#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.


#5

You can find the latest version of the OpenJDK here.