diff --git a/bindings/java/java/README.md b/bindings/java/java/README.md
new file mode 100644
index 000000000..47e178351
--- /dev/null
+++ b/bindings/java/java/README.md
@@ -0,0 +1,21 @@
+## Java Bindings
+
+This bindings have been tested with `openjdk64-11.0.1` on OSX and debian:latest.  
+For examples of how to use these bindings take a look at the JUnit tests.
+
+### Build and test
+
+from project root:
+
+```bash
+cd bindings/java && make clean build test
+```
+
+### Build and test (debug with debug printouts)
+
+from project root:
+
+```bash
+cd bindings/java && make clean debug test
+```
+